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Foreword 



. jtlmLcamm to th« wazld ot aicroconputara opened bo /ou by your 
ZII09* ZSOOO" microprocessor. Welcoa* also to tlis vforld of 
application software accessible through your Digital Research 
CP/M'->dOOO"* operating syatea. Digital Research designed CP/H- 
8000 especially for the Zilog ZdOOO nicroprocessor which is the 
heart of your coaputer. 

Wluiik Clr/W 8090 lisMw IP^nr Tsim 

C9/H<»d000 aanages and supervises your c^^puter's resources, 
incliHling aesory, console (screen and keyboard)/ printer^ and 
cowBuni<3atione devices. It also manages inforaation stored 
magnetically on disks by grouping this inforaation into 
j^ograaa or data files. C9/M«8000 can copy files from a disk 
to your coiq>uter*s nsosoryf or to a peripheral device such as a 
printer. To per form these functions, CP/H'-aooo places various 
programs into your computer ' s memory and executes them 
aeeordixig to coaaandm you mxtmc at your ccmsole. 

itaee in aemoryf a program runs through a set of steps that 
instruct your compter to perform a cer^iin task. You can use 
CP/HHSOOO to create your own programs* or you can choose from 
the vride variety of C?/M-€000 application programs that 
entertain* educate* and help solve your commercial and 
scientific problemm. 



The CP/M«dOOO operating system runs on the Zilog Z8000 
olcroprooeeeor * You need that microprocessor, a console device 
ti^merally a keyboard and display device such as a CRT screen) , 
and at least one floppy disk drive. To use all the 
capabilities of CP/M-dOOO. you should have at Least two disk 
drives. CP/M'>8000 supports a hard disk subsystem, should a 
hard disk be part of your computer system. 

CP/M-^OOO and its utility programs are distributed on 5 1/4- 
inch floppy disks. The system disk contains the operating 
system and the most commonly used utility prograae. Utility 
programs* or utilities* are application programs supplicKl with 
an operating system that perform housekeeping tasks, such as 
copying files or showing you the amount of free space on a 
disk. 
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The remaining disks contain additional utilities, plus the 
Unidot C conpiler, the C iajsguage library, files that can be 
used to build varaiona of CP/M-SOOO adapted to a variety of 
hardware environnenta, and sample Basic Input/Output Systems 
{ BIOS ) . 



CrrmSOOe nm^mmcmtmMmm Set 

The CP/M-3000 documentation set includes three manuals: 

• Q*/t^8000 Operating System User's Guide (cited as CP/M-aooo 
User ' s Guide ) 

• Cg/M~8000 Operating SvstetKProaraaaer' a Guide (cited as Ci'/M- 
eooo Programmer ' a Guide } ' 

• C£'/Mp"6000 Operating System Svataap Guide (cited as CP/M-aooO 
System Guide ) 

The CP/M~8000 Uu^T ' s Guide introduce* you to the CP/M-aooo 
opspTttting ays tea and desctibea how to use it. The us«r's guide 
assuaes that the version of CP/M-SOOO on ycMir distribution disk 
IS ready to run on yoiir cosputer. to use this aaxuial, you oust 
> be familiar with the parta of your coi?»ut«r, know how to set it 
up auad turn it on, and how to handle, in*«rt, and store disks. 
This guide dOits not, however, assume you have great deal of 
experience with eooputsrs. 

The CP/M-8000 Proerrammsr ' a Guide prssawsta information for 
application progranwers who are creating or adapting programs 
to run under CP/M-8000. The prograaaaer ' « guide includsa 
information on the CP/M-8000 asaembler and debugger that 
exparienced programmer a can use to create new CP/M-SOOO 
programs . 

The CP/M-8000 System Guide describes the procedures required to 
adapt CP/M-8000 for a variety of hardware environments. 

This guide begins with simple exas^lea. pepeseids with basic 
concepts, and then presents a detailed reference aection on 
CP/M-8000 'a commands. The firat four sectiona describe CP/M- 
3000 operation for the fir at- time us«r. 

Section 1 introduces CP/M-8000 and tella you how to start the 
operating syatem, enter commands, edit the coamand line, and 
create backup copies of your distribution disks. Section 2 
discusses files, disks, and drives. Section 3 describes how to 
use CP/M-8000 to manage your printer and console. 
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Sac^iox 4 axplains concttpta that will help you to use CP/h^BOQQ 
Qomaanda bo your b««t advantage. It you axe aew to CP/H*, read 
the first toixx sections carefully. They give you a 9eneral 
understanding of how to use the operating system before you 
proceed to the specific cooaend descriptions. 

Section S provides detailed inf oraation on CP/M-€000 ' s utility 
prograas. It is arranged alphabetically for easy reference* 
Section 6 tells you how to use ED, the CF/M-6000 file editor. 
With 2D, you can create and edit program source, teaet« and data 
files. 

Appendix A lists the aessages CP/M-dOOO displays when it. 
wicounters special conditions, and describes corrective actions 
where necessary. Appendix: S lists the filetypes associated 
with CF/H-aoOO. Appendix C lists and defines the C9/H-6000 
control characters. Appendix explains the operation of a 
aachine->«peci£ic FORMAT utility. The Glossary provides a list 
of ccauBonly used coa^uter teras. 

Please mte that boldface type follow iog the computer proapt in 
aammaud lines represents user input. 

If yott lucm new to coapaters, you aight find soae of the topics 
a bit difficult to understand at first. Learnixsg to use your 
coaputer is a challenge, and we hope you'll find it fun. This 
book aoves step'by->step so that you can quickly proceed froa 
opening your new iiystea disk package to using CP/lt-dOOO * s 
powerful facilities. 
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Sectioji 1 

Introductton to 
CP/l[-8000 



thltf sttction t«il« yoo Hom to start CP/M->€000, how to •atsr mad 
«dit a ooaaand Iin«» and how to aaJca bacle;^ copias of your 
CP/f9-dOOO distribution diska. 

start ia»g or loadiaug CF/M-8000 aaana cauaisg your eoaputar to 
raad a cc^py of tha oparatiag systaa froa your CP/Mr-8000 tystaa 
diak into ita aaaory. Thia la ealJLad a boot or coXd start. 
flacTMiiaa tha boot prooaaa variaa from coaputar to cts»qpatar« you 
■uat follow tha aamifaetursr ' s Inatruetiona tor tha coaputar 
yoo aaa* Tha aaxt two paragrapha daveriba a typical^ but not 
uaivarsaX* booting proeaaa. 

fixm^* turn yoar coaputar 's powar switc±i to ita "on" poaiticm. 
Haaet* iziaart your CP/M-dOOO syataa diak into tha coaputar 's 
initial driva «nd cloaa tha driva door. Tha Initial driva ia 
also tha dafault driva, tha driva CF/H-dOOO goaa to if no driva 
ia spacifiad. In thia saction* aaauaa that tha initial driva 
is h and tha diak is ranovabla. tlow prsaa tha RESET or RSSTAJlT 
button. Thia automatically loada CP/M>-€OQO into your 
coaputar 's aaaory. 

If you want to raata,rt CP/H-dOOO at soaa point aftar initially 
Iffisriing tha syataa, first aaka sura your C^/M-aOQO systaa disk 
ia in tha initial driva and than praaa tha RS$S7 ca: RESTUBT 
button. Thia is callad a aystsst raaat. It haa tha aaaa sffaet 
aa prssaing RESET or RZSTA£T whan you first powar up your 
coaputar. Parforaing a systaa rssat araaaa any data prsvimsly 
loadad into your coaputar 's aaaory. This aaans that any data 
not atorad on a disk is Lost. 

Aftar CP/M'dOOO is loadad into aaaory, tha follow izxg aaasaga is 
displayad on your scroan: 

CP/M^8000(ta) Varsion n-n 03/17/34 
Copyright (c) 1984 Digital Rasaarch Inc. 

Tha varsion nuabarv rsprssanted abova by n.n, tslls you tha 
varsion of CF/M~dOOO that you own. Aftar this display, tha 
following two charactars appaar on your scraan: 

A> 
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CP/M-8000 User's Guide How to Start CP/M-BOOO 

This is the CP/M-SOOO system prompt. The systaa prompt tells 
you that CP/M-6000 is ready to read a command from your 
keyboard. In this example, the prompt also tells you that 
drive A is your default drive. This aeaxis that until you tell 
CF/H~8000 to do otherwise, it looks tor program and data tiles 
on the disk in drive A. 

CP/M-8000 performs certain tasks according to specific commands 
that you type at your keyboard. A CP/M-8000 command line 
consists of a command keyvford, an optional command tail, and a 
RETURN keystroke. The command keyword identifies a command 
(program) to be executed. The coasand tail can contain extra 
information for the coamand, such as a filename or parameters. 
To end the command line, you must press the RETUBN key. Hote 
that the RETURl? key can be marked SJ3TER, RCTURS, CR, or 
something similar on your keyboard. In this guide, RETURN? 
refers to the R£TU^ key. 

As you type characters at the keyboard, they appear on your 
screen. The single-character position indicator, called the 
cursor, moves to the right as you type characters. If you make 
a typing mistake, press either the BACKSPACE key (if ycxir 
keyboard has one) or CTRL-a to move the cursor to the left and 
correct the error. CTRL is the abbreviation for the COfilTROL 
key. To type a ccaotrol character, hold down the CTRL key and 
press the required letter key. For example, to move the cursor 
to the left, hold down CTRL and press the H key. 

You can type the keyword and eooaumd tail in any combination of 
uppercase amd lowercase letters. CP/M-8000 treats all letters 
m the command line as uppercase. 

Generally, you type a command line directly after the systoua 
prompt. However, CF/H-8000 does allow spaces between the 
prompt and the command keyword. 

Let's use the OIR command to demonstrate how CP/M-8000 reads 
command lines. The OIR command tells CP/M-8000 to display a 
directory containing the najnes of the disk files on your 
screen. Type OIR after the system prompt and press RETURH. 

A>DIIl 

CP/M-8000 responds to this command by writing the names of 
those files that are stored in the default storage area. For 
example, if you have your CP/M-8000 system disk in the 
default drive A, these filenames, among others, appear on your 
screen : 

STAT Z8K 
PIP ZSK 
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CF/M-aoOO U9«r ' 3 Guide Coaunand Lina 

C?/l4-dO0O takes the cosuaand exactly as you type It and copparss 
your input to executable program files in the CP/M->€000 
directory. If the comaand matches a prograa file in the 
directory, CI>/M<-a000 executes that prograa. I£ the first word 
you type do«>« not aateh any file in the directory, CP/M-aooo 
echoes this coaoand and puts a question mark after it. For 
ezajqple. if yois mistype the Dia coaaand as OJR. you s«« tha 
foXlowings 

OJB? 

which tells you that CP/H-€000 cannot find that ctnuand. To 
correct simp le typing mtTOZS, use the BACKSPACE key, or hold' 
doMn the CTBL key and press B to mcrrm the cursor to the left. 
You cannot correct typing errors after you press the RETUBH 
key. the cc«aand mast then be typed correctly in its entirety. 
CP/M-€000 supports other control characters that help you edit 
cosMuad lines efficiently. Section 3 tells how to use control 
characters to edit coaaand lines anil other inforaaticui you 
eater at your console. 

the OXE coaaand accepts a fileaaae as a enaaand tail. You can 
us* OXH with a filenaae to saa if a specific file is on tha 
disk. Tor mxMoplm, to check that tha transient utility prograa 
COFST.ZSK ia on yeoxr syatea disk^ typa 

A>oia Govr.zaK 

C9/M«28K parforas «:his task by displaying either the naaa of 
tha file you specified or tha oassaga "iKo File." 

Mm stare to ty|M at leaet one space after OZH to saparate tha 
coaaand keyword froa tha comsand tail. If you do not. CP/M-> 
3000 respcmds as shown. 

A>OZBCOPT. sue 

aXSCOTY. ZdK? 



WhyY— ^fcacMBMifciryY— ggn— 



Bamma or coaputer errors soaetioaa destroy valuable prograaa or 
data files. By loistyping a coaaand, for exaja^le. you can 

accidentally erasw a prograa that you just created or a data 
file that has been months in tha making. K siailar disaster 
can result froa an electronic eoaponent failure. 

Data processing professionals avoid losing prograas and data by 
making copies of valuable files. Always make a working copy of 
any new prograa you purchase and save the original. If the 
prograa is accidentally erased froa the working copy, you «-»" 
easily restore it froa tha original. 
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CP/M-8000 Doer's Guide Why You Should BacK Up Your Piles 

It is also wise to maXe frequent copies of new prograns or data 
files as you develop them. The frequency of making copies 
varies. As a general rule, make a copy at the point where it 
will take ten to twenty times longer to reenter the information 
than it will to make the copy. 

Bot*: If you suspect a hardware problem has interfered with 
your copying, do not use your valuattXe backup disk to rest&rt 
or cont.in.ue the ci^^ process. Eardware problems have even 
greater potential for causing harm to your disks than software 
problems do. If you n»ed to locate a hardware problem, use 
noncritical disks. 



So far, we have not discusssd any comBsaouds that change 
information recorded on your CP/M-3000 system disk. S«fore wer 
do, make a few working copies of your distxibutioo disks. 

To back up your CP/M-8000 disks, you need several floppy disks. 
The backup disks can be factory -fresh or u»«d. You might want 
to format new disks or reformat used disks with the disk 
formatting program that aeco^paziies youx particular coaputer. 
If the disks are used, make sure that they do not onstais any 
files that you want to save. 

If your coB^uter's manufacturer has provided a special program 
to copy disks, you can use that program to make backups, 
otherwise, you can use the COPY utility program that cowes with 
CP/M-8000. COPY is a track -by-track disk copying program that 
can copy the operating system loader and utility programs from 
your system disk. COPY creates an exact copy of your system 
disk. Before you can use COPY however, you probably have to 
format the disks that will become your backups. Formatting 
writes the proper density, sector sise, and number of tracks 
onto disks so that they can be used with CP/M-8000. See 
Appendix D for a description of a machine— specific FORMAT 
utility. 

To use the COPY utility, simply type COPY and press the RETDRH 
key. You s«e the following message: 

COPY VER 1.1 

followed by a mode menu: 

MODE FUNCTION 

ALL Copy the whole disk 

BOOT Copy the boot tracks only 

FILES Copy the files only 

END End the program 
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CP/M-QOOO User '3 Guide Elow to Copy Your CP/M-8000 Disks 

S«i«ct the "ALL" mode for backing up your CP/Hr8000 
distribution disks by typing ALL and pressing R£TUBN. The 
foXlowing proiq>t appears on the screen: 

Sntstr SOUBCB drives _ 

TBaa mamt bow eater a drive letter froa A to P and press mETURH. 
Beeause your CP/M-8000 syetea disk is in drive A, press A, and 
then preffs RBTtlBH, The prograa then proapts you to 

Enter 0E8TX12A7IO1I drives _ 

Again* you oust select a drive letter, and press RETDBN. Then 
the prograa gives you a chance to abort the process by 
proapting: 

(*C to ABORT) 

RBTCIRIf to copy All froa A to <destination> 

The prograa gives you a chance to review what you salected 
before proceeding. If you atill Mant to proceed, press the 
. BBTOKff key. X£ wot, hold down the control key vihile pressing C 
(* aeane "CTHL" in the exaapXe above) «nd the process is 
tarainatad. 7or an expanded treataant of COPY see Section 5. 

End of Section 1 
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Section 2 

Files, Dislcs, and Driires 



C9/M-S000*s ao«t laportaat task im to acesss and aaiatain fllaa 
on yoar dlaka. With CF/M-^000 you can entata. raad, writa, 
copy, and araM dlak fllaa. Thia taction talla you what a f ila 
ia* how to craata* aaoa* and accaaa a fiXa* and how f ilaa. ara 
atorad on your diaka. It alao talla hOM to changa diaka and 
changa tha dafault driva. 



A CP/H-8000 fila la a collaction of calatad inforaation storad 
on a diak. Svary fila on a givan diak auat hava a unlqua naaa 
bacauaa CS/H*a000 aaaa that nana to accaaa that fila. A 
dizaetory la alao atorad on aach diak. Tha diractory containa 
a Uat of th* filaa atorad on that diak and tha loeationa of 
aaeh fila on tha diak. 

In g«naral« thara aara two kinda of filaas prograa (eonand) 
filaa and data filaa. A prograa fila la an axacutahla fila, a 
aariaa of inatructiona tha cosputar can follow stap by stap. A 
data fila la uaually a collaction of inforaation: a liat of 
na»aa and addraaaaa, tha inv«itory of a stora. tha accounting 
racorda of a buainaaa* tha taxt of a doeuaant, or sioilar 
calatad inforaation. For axaapla* your coaputar cannot axacuta 
aaaaa and addraaaaa, but it can axacuta a prograa that printa 
naaaa and addraaaaa on nailing labala. 

A data fila can al*o contain tha aourca coda for a prograa. 
Oanarally, a prograa aourca fila auat ba proeaaaad by an 
aaaaablar or coapilar bafora it bacoaaa a prograa fila. In 
aoat caaaa. an axaeuting prograa procaaaaa a data fila. 
Etowarar, thara ara t:Laaa whan an axaeuting prograa procaaaaa a 
prograa fila. For axaapla", tha copy prograa, PIP, can copy ona 
or nora prograa filaa. 



Thara ara aany waya to craata a fila. You can craata a fila by 
copyixm an axiating l!ila to a naw location, parhapa rananing it 
In tha procaaa. With CP/M-aOOO, you can u»« tha PIP c omman d to 
aagy and canaaa filaa. A sacond way of creating a fila is to 
uaa a taxt aditor. Tha CP/H>€000 taxt aditor EO, daacribad in 
Saetion 6, can craata a fila and aaaign it tha nana you 
•pacify. Finally, soma prograaa such aa ASM* craata output 
filaa aa thay procaaa input filaa. 
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CP/M-8000 User's Guide Naming Files 

CP/M-8000 identifiea every file by ita unique file 
specification. The simplest )cind of file specification ia a 
one* to eight-character filename, auch aa: 

MYFILE 

Ai £%le jupeciSieation can have up) , to three parta: a drive 
specifier, a filename, and a filetype. 

The drive apecifiier ia a single letter (A through P) followed 
by a colon. Each drive in your systea ia aaaigned a letter. 
V4hen you include a drive specifier aa part of the file 
specification, you are telling CP/M-aoOO that the file i« 
stored on the diaic currently in that drive. .For exaji^le. if 
you enter 

BrMYPILE 

CP/M-8000 looka in drive fl for the file MXPILE. 

The filename can be froB one to eight characters. When you 
create a filename, try to let the name tell you aoaething about 
what the file contain*. For example, if you have a list of 
customer namea for your business , you could name the file 

CUSTOMEB 

so that the name ia eight or fewer characters, and gives you 
some idea of what la in the file. 

As you begin to use your computer with CP/M-SOOO, you will find 
that files fall naturally into categories. -To help you 
idemtify files belonging to the aame category, CP/H-8000 allows 
you to add an optional one- to three— character extension, 
called a filetype, to the fileneime. When you add a filetype to 
the filename, you oust separate the two with a delimiter, in 
this case a period. Try to use three letters that will tell 
you something about the fil»'a category. For exaa^le, you 
could add the filetype KAM to the file that contains a list of 
customer names as follows: 

OJSTOKSR.IZAM 

When CP/M-dOOO displays file specifications in response to a 
directory or DIR command, it adds blanlcs to short filenames so 
that you can compare filetypes quic>cly. tlotice that the period 
delimiter does not appear on your screen. 

The program files that CF/M-8000 loads into memory from'a disk 
have different filetypea, but are in t±ie category of ZSOGO and 
equivalent programs that run with CP/M-8000. The filetypes Z8K 
'*■■ and REL identify this category of executable programs. 
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We recoanend that you create file specifications from letters 
and niUBbers. Becauaa they have special meanings for CP/M-SOOO, 
you oust not use the following characters in filenames or 

f iletyp«ris i 

<>-,l|*?ft/C3().t;+'-\ 

A eoapletitt file speeificaition coatainiag all poseible eleaeata 
consiata of a drive specification, 3 primary filename, and a 
filetype, each separated from the others by its appropriate 
dttliaitera, as shoMia in the following example: 

KtDOCOKBSrS.LMf 

lAien you type a file specification in a command tail without a 
drive specifier, the built-in or transient utility looks for 
the file in the default drive, the drive named by the system 
prompt. For exaaple, if yeni type the command 

k>aiM C0F7.Z8K 

OXR looks in th» directory of thm disJc in drive A for COPY.ZSX. 
X£ you have another drive* B for example, you need a way to 
tmil CP/M-aooO to aceema the dlak in drive a and not the disk 
la the default drive. For this reason. CP/M^aooo lets you 
precede a filename with a drive specifier. For example, in 
response to the command 

A>02:R B*Mr7XXJE.I.IB 

GP/M-^00 looks for ths file MY7ILS.LIB in the directory of the 
disk in drive 3. When you give a cowsand to CP/M-8000, you 
should note which disk is in the default drive. Many 
a^licatioa programs rsquire that th« data files they access be 
stored in the default drive. 



You can also precede a program filename with a drive specif 
ev«aif you usm the program filename as a command keyword, 
exaaople, if you type the following command: 

A>as#z? 



ier. 
For 



CP/M-6000 looks in the directory of the disk in drive B for the 
file PIP. 777. If <3P/M-aOOO finds PIP on drive B, it loads PIP 
into memory and executes it. 
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If you need to accasa aany files on the sane drive, you Blight 
find it convenient to change the default drive ao that you do 
not need to enter a drive specifier repeatedly. To change the 
default drive, ainply type the drive specifier ( including the 
colon) next to the system prompt and press RETURN. In 
response, CP/M-8000 changes the system prompt to display the 
new default drive: 

A>Bt 
B> 

As you have seen, the drive specifier is an important part of 
the file specification. Moving a disk to a different drive 
changes the file specifications for the files on that disk. 
Please keep this in mind when moving your dinks from one drive 
to another. 

Section 4 presents more iaformatioa on how CP/M-SOOb locates 
program and data files. 



Files Calas ^am €^rT9et Ci 

CP/M-8000 further identifies all files by assigning each file a 
user nuasber from to 15 when the file is created. The user 
nuaiber for each file is recorded in the disk directory. User 
numbers allow you to separate yoiir files into sixteen file 
groups. User nuoiaers are particularly useful for organizing 
hard di»k space. 

When you use a CP/M-8000 utility to create a file, the file is 
assigned to the current user number, unless you use PIP to copy 
the file to another user number. You can determine the current 
user nuBsbex by looking at the system prompt. 

4A> User nuadser 4, drive A 

A> User number 0, drive A 

2B> User number 2, drive E 

The user number always precedes the drive identifier in the 
system prompt. User 0, however ^ is the default user number and 
is not displayed in the prosit. 

You can use the built-in command USER to change the ctirrent 
user number. 

A>aSKR 3 
3A> 

Most coBBsands can access only tliose files that have the current 
user number. For example, if the current user number is 7 , a 
DER command displays only the files in user 7. However, if an 
executable program file or a SUBMIT file resides in user 0, 
that file can be accessed from any user number. See Section 5 
for more information on SUBMIT files. 
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More tluuA 0»e Fil« 

Ourtain CP/M-dOOO built-in and transient utilities can select 
and process several files when special wildcard characters are 
included in the £ilena«e or fiiletype. h file spetsification 
coBtaining wildcards can refer to acre than one file because it 
gives CP/H-dOOO a pattern to aatch. CF/H->a000 searches the 
disk directory and selects any file whose f 1 Lenaae or f iletype 
Batches the patltem. , ^^ 

The tMO wildcard characters are 7, which natchee any single 
letter in the sane position and *, which aatches any character 
at that position and any other dbaracters resaining in the 
filenaae or filetype. The &9llowing list presents the rules 
f«t using wildcards. 

• A ? Batches any character in a oasM, including a space 
character. 

• An * anat ba the last, oe only* cSiarmcter in the filenaas or 
filetype. CP/M->8000 internally replaeee an *■ with ? 
cftLaractera to the end o£ the filenane c^ filetype. 

• Itiea the filanasM to aatch ia shorter than eight cdiaxacters. 
CP/M-aOOO treats th# aasM a« if it ended with spaces. 

• Mhsn the filatypa to aatch is shorter than three dliaracters. 
CP/H-8000 treats the filetyp* aa if it ended with spaces. 

Siq^ose* for exaaiile. yoo have a disk that containa the 
following six files « 

K.ZBK, AA.ZSR, AAA.ZSK, B.ZSK, A.JUEL, and B,BXL 

Thtt following wildcard specif icatioaa aati^ 411« or a portion 
o£« tha preceding fileat 

♦,♦ is treated as ?77??777.7?? 

77777777. 77? Batches all six nanes 

•.28K is treated aa 77777777. ZSK 

7777777? .ZSK aatciiea the first four naaee 

?.zax Batches A.ZSK and B.ZSK 

?•* ia treated aa 7.777 

7.777 Batches A.ZSK* B.ZSK, A.REL, and B.REL 

A?.2aK Batches A.ZdK and AA.Z8K 
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A*.2aK is treated aa A7777777.Z8K 

A7777777.28K matches A.Z8K, AA.ZSK, and AAA.Z8K 

RamsBber that CP/M-8000 ua«8 wildcard patterns only while 
searching a disk directory. Therefore, wildcards are valid 
only in filenames auid filetypea. You cannot use a wildcard 
character in a drive specifier. 

File 



When you create a file, CP/M-8000 gives it two attributes: DIR 
(for Directory) and R/W (for Read-Write). Through the STAT 
command, you can change these attributes from DIR to SYS (for 
System) and from R/w to R/0 (for Read-Only) . 

The DIR and SYS attributes control whether CP/H-8000 displays 
the file's name in response to a DIR command or DIRS c om m an d. 
DIR displays only the file specifications having the DIR 
attribute; DIRS displays oaly the file specifications having 
the SYS attribute. 

I^i emcond file attributm can be set to either R/w (Read-Write) 
or R/0 (Read-only). If a file is max)ced R/0, any attescpt to 
write data to that file produces a Read-Oaly error meeaage. 
Therefore, you can u«« the R/0 attribute to protect important 
file*. A file with the R/W attribute can be read or written to 
at any time. For more information on setting file attributes, 
see the STAT command in Section 5 . 

CP/M-aOOO records the filename, filetype, user number, and 
attributes of each file in a special area of the disk called 
the directory. In the directory, CP/M-8000 also records which 
parts of the disk belong to which file. You can use the 
STAT command to determine the number of entries in your 
directory. 

CP/M-8000 allocates directory and storage space for a file aa 
records are added to the file. When you erase a file, CP/M- 
8000 reclaims storage in two ways; it makes the file's 
directory space available to catalog a different file, and it 
frees the file's storage space for later use. This handling of 
storage and directory space, called dynamic file allocation, is 
a powerful feature of CP/M-8000. You do not have to tell CP/M- 
8000 how big your file will become, because it automatically 
allocates more storage for a file as needed, and releases the 
storage for reallocation when the file is erased. Use the STAT 
comjoand to determine how much snace remains on the disk. 
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duuiCing VUBpffj Wmkm 

CP/M»dOOO caxmot, of cours«f do anything to a fil« unlsaa th« 
disk that holds tho £il« is isiMirtsd into a drivs and th« driva 
is rsady. >lt«ii a disk is ii% a drivs, it is on->lin« and CP/M- 
8(000 can accsss its diraotory and fiilss. 

At soas tins* you will nssd to taks a disk oat of a driv« and 
insart anothar that containa diffarant filaa. You can raplaca 
an on-llna disk wh«x«var you saa tha systaa prompt at your 
oonsola. This is a claar indication that no program is raading 
£zoa or writing to t±ia disk in tha driva. 

You can also raaova a disk and insart a nm*i ona whan an 
aspli cation prograa proapts you to do so. This can occur, for 
axaapla, ^Aima tha data that tha prograa usaa doas not fit on 
ona floppy disk. Hota that you suat navar caaova a disk if a 
prograa is raading froa or writing to it. 

Attar you insart a floppy disk at ta into tha driva, you oust 
praaa CTRL-C. By praaaing CTBL-C* you inform CP/M~dO00 that 
all drivaa hava baan raaat to tha Baad-Mrita ata^i. This 
anahlas ycu to ra4Ml and wrlta to tha nmn diskatta. Saa 
"TaraiflAtiag Frograas" in Sactioa 4 for aenra inioraation on 
CSIiL'-C. Rafar to tha Cg/HKacX)0 Proqgaaaar's Quids for aora 
iaforaation on disk handling* 

Sod of Saotlon 2 
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CoDUKile and. Piriiiteir 



This a«e%ion d*8crib«« how CP/M-dOOO coaaauiicatas with your 
conooJL* and printar. It shows you how to atazt and stop 
consols and printsr output, sdit coaaands you sntsr at your 
csonsoXs* and rsdirsct consols and printsr input and output. It 
also sxplains ths concspt o£ logical dsvicss and how thsy ars 
ussd undsr CF/H-^OOO. 



Somstioss CP/m-€000 displays information on your scrssn too 
quickly for you to rsad it. An sspseially long display can 
scroll off ths top Qt your scrssn bsfors you hav« a chaxics to 
study it. You can tsll ths systsa to wait whils you rsad ths 
display by holding down ths CTRL Icsy and prassing S. h CTBI>>S 
causss ths display scrolling to stop* Whsn you ars rsady for 
ths display to eontinus scrolling* prsss CTRIX3. 



You can also uss a control coanand to '*scho'' consols outlet at 
ths printsr, if you havs ons* To start printsr scho, sntsr a 
CTBL-P. To stop printsr scho# sntsr anothsr CTRL-P. Mhils 
printsr scho is in sffsct, any charactsra that appsar on your 
serssn ars listsd at your printsr. 

You can ass printsr scho with a OZR coaaand to aaJcs a list of 
ths fils s storsd on a floppy disk. You can also ass CTRL^P 
with CTSIrHS and CTRli-O to aaks a hard copy of part of a fils. 
Uss a TYSB ccosaand to start ths display of ths fils at ths 
consols. Sss Ssction 5 for aors dstail of ths STAT conaand. 
Whsn ths display rsaehss ths part you nssd to print, prsss 
CSBLr^ to Stop ths display, CTRL-P to snahls printsr scho, and 
than CTRL-0 to rssiuis scrolling ths display and start printing. 
You can uss anothsr CTRL'S, CTRX*'P, CTRLiHS ssqu«ica to 
tsrainats printsr scho. 



You can corract simpla typing aistakss in a comaand lins with 
tha BACKSPACZ or CTRL-a kay. CF/M~€000 also supports 
additional lina-aditing functions that you parfora with control 
<±uaractars. Ycm can asa tha control char ac tars to adit cosuoand 
linas or input linas to most programs. 
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Console Line Editing 



CP/M-aOOO allows you to edit your command line using the set of 
characters listed in Table 3-1. To edit a command line in 
CP/M-8000, use control characters to delete characters to the 
left of the cursor, then replace them with new characters. 

In the following ezaAple coBmand line, the coiBsand )ceyword PIP 
IS mistyped. The underbar (__) represents the cursor. 

A>POP Aj-Bs*.*_ 

Tb nove the cursor to the letter 0, hold down the CTRL key and 
press letter B eleven tiaas. CTRIr-B deletes characters as it 
aovtts the cursor left, leaving the following comjhand line: 

A>P_ 

Ikjw you can type the correct letters, press KSTUKK, and send 
the comaand to CP/M-6000. 

a>pi:f A,i-fl«*.*^ 

Table 3-1 lists all line-editing control characters for CP/M- 
aooo . 



Table 3-1. CP/M-BOOO Llner>«di.tJLDg OontroJL Characters 



Character 



Meaning 



CTRI>S Forces a physical RETUSH but does not send the 
coBBand line to CP/M-dOOO . Moves the cursor to 

'^'-' the beginning of the next line without erasing 

your previous input. 

CTRL-H Deletes a character and moves the cursor left 
one character position. Has the sane function 
as backspace. 

CTHlr-I Moves the cursor to the next tab stop. A tab 
stop is autosatically set at each eighth coluan. 
Has the sajee effect as pressing the TAB key. 

CTIU>>J Sends the cooBMand line to CP/H-8000 and returns 
the cursor to the left of the current line. Bas 
the saxie e££*et as a RETUKK or a CTRL-H. 

CTRL-M Sends the coumand line to CP/M-6000 and returns 
the cursor to the left of the current line. Has 
the saae effect an a R£TUR£f or a CTRL-J. 

CTRL-R Places a ♦at the current cursor location, 
moves the cursor to the next line, and displays 
any partial coauaand you typed so far. Pressing 
RETURN sends the command to CP/M-3000. 
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T^iUsle 3-1. (continued) 



C2u9tract«r 



Meaning 



CTBL-U Oiaeaxds all the characters in the eoaaand line* 
places a # at the current cursor position* and 
■ovee the cursor to the next cosusand line. 

cnKEI-X Discards all the characters in the coaueand line 
and. aoves the ciirsar to the beginning of the 
ctxrreat line. 



You probably noticed that some control characters have the sane 
aeaning. For exaatple* the crCRLr-^ and CTRLr-M leeystrokea have 
the saae effect as pressing the RETURN key; all three send the 
CTBHwanrt line to CP/M-8000 for processing. Also, CTRL-a: has the 
same effect as pressing the backspace key. 



Most CP/H-aooO ccsiputsr systaas have a traditional console with 
a keyboard and screen display. Many also have letter •quality 
printers. If you use your ccaputer for unusual tasks, you 
aeight i#aat to add a different kiod of character device to your 
systeat a line printer « a teletype terminal, a aodea« or even 
a joystick for playing gases. To keep track of these 
physically different input amd output devices, CP/M~dOOO 
associates different physical devices with logical devices. 
)Rien ytaa receive your CP/M»a000 system, the logical devices are 
assigned to physical devices as shown in Table 3*2. 



tiiblm 3-*2. CP/M-aooo Logical Oevi 



Logical tiaaa 


Oeviea Type 


Physical Asaignaent 


COir< 


Console input/ 

CfUtpUt 


Keyboard / Scr aen 


AXIt 


/fkuxiliary input 


Auxiliary input port 
( if one exists) 


AXOs 


Auxiliary output 


Auxiliary output port 
( if one exists) 


LSTs- 


i:«ist output 


Printer 

( if one exists) 
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Logical names are assigned to physical devices by the hardwaire 
aanufacturer. However, in sonte imp leoan tat ions of CP/M-8000, 
you can change these assigmctents with the STAT coomand. For 
example, you can assign AXX and AXO to a aodem so that your 
coaputsr can coauaunicate with others over the telephone. See 
STAT in Section 5 , for a description of how to change logical 
name to physical device assigruaents. 

End of Section 3 
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CP/lI-8000 Commajid 
Concepts 



fm diMcaanmd la Smction I, a CP/M-8000 ccaouuidl linm conaists of 
a ecauumd )c«yword, an optional c^uMnd tail^ and a RETUBH 
k«yst70k«. Thia aaetion daseribtta tha turn kinda of prograna 
tha coaaand kayiiiord can idantify, and talis how G?/M-dOOO 
aaarehaa for a prograa fila on a diak. It also talis how to 
aiwcuta aultipla CP/M-dOOO cosuBands, and h^ir to raaat tha disk 
syataa. 



A roaaanrt kaywocd Idantif iaa a prograa tbat raaidaa aithar In 
•wory aa part of C9/HhS000» or on a disk aa a progra« fil*. 
roi—nfla thai: ida&tify proginuui la aaaory ara oallad built-in 
ooaaanda. CoiUHU&da that idaatify progran filaa oa a diak ara 
callad tsaaaiaal; atility eoaaaada. 

Savaa buiXt^ia coaaanda and awaral tranaiaat utility cooaanda 
ara Includad with C7/M<-d000. Yoo can add utilitiaa to your 
ayataa by purchaaiag varioua CP/M-BOOO->co^patibla application 
prograaa. If yoQ ara aa axpariaaead programaar, you can also 
writa your owa utilitiaa that oparata with CP/M-dOOO. 



SaiXtt-la 



Bailt-ia cnaaanrta ara part of C9/M'-^0Q0 and coaa into aaaory 
t^aa you boot tha syataa. Saeauaa thay raaida in aaaory at all 
tiaaa, built<>ia coaaaada hava ti«o advaatagaa ovar traaaiaat 
coaaaadas 



Built* in coaaanda 9,r9 always availabla ragardlaaa of tha 
currant uaar nuabar or da fault driva displayed in tha 
coaaand proapt. 

Built-in coaaanda start axacuting mora quickly than tha 
tzanaiant utilitiaa bacausa thay do not hava to ism raad froa 
a diak. 



Saction 5 giv«a you tha oparating datails of tha built-in 
cfflsaanda listed in Tabla 4-1. 
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Two Kinds of Coaunaiids 



Table 4-1. Built-in CojouLads 



Cnmmnnd 



Punction 



DIR Display* filenajnea of files aarVrad with the DIR 

(Directory) attribute in the directory. 

DIRS Displays filenaaes of files marlced with the SYS 

(Systen) attribute in the directory. 

ERA Erases a file from the disk by renoving the 

filename from the directory and by releasing the 
storage space occupied by the file. 

RiSH Renastes a disk file. 

SUBMIT Executes a list of eoasands contained in a 

SUBMIT file that you create. 

TYPE Displays the contentis of an ASCII (readable 

characters) file on your screen. 

USSR Chaxigea the current user nujiber . 



CP/M-8000 does not allow you to abbreviate the built-in 
cosaands. 



Traasieat Utility Coaosands 

A transient utility cosuaa n d executes & progr&a that comes into 
mefflory only when you request it. When you enter a comaand that 
identifies a transient utility, CP/M-8000 loads the program 
file from the disk and passes it the filanajnes, data, or 
paraaeters you entered in the cosmand tail. Because these 
programs axe loaded fro« disk, the disk with the prograa file 
must be accessible to execute the coanand. How CP/M-SOOO 
searches for e oaw a n d files is explained later in this section. 

Section 5 provides the operating details for the aost 
. frequently used CP/M-8000 transient utilities listed in Table 
4-2. Less frequently used utilities are described in the CP/M- 
aOOD Prograaaer's Guide . Many of the utilities listed in Table 
4-2 are prograaaxng tools that are of use only to systems and 
applications prograaaars. 
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Two Kinds of Cosuoands 



T&bJLtf 4-2. Traxuiiaiit Utility Conwnds 



ttoa« 



Fuxiction 



Wh«rtt Sxplaincd 



AASK 

ASZ8K 

COPY 

DOT 

OOMP 

SO 

?0RItt.7 



Stor«s obj«et £11«« in th« 
C nin-tiaMi library? tha 
Arehiva utility. 

Xavokaa th* aaaaablar. 



Copiaa diaka ( ineludixtg 
CP/M-aooo boot diaka), 

Izsvokaa Z8000 DDT, tba 
CP/H-»€000 datouggar. 

Oisplaya « ffila in ASCII 
and haxadttoimal fiomata. 

Craataa and altara 
charactar f ilaa. 

Marka all diak aactora 
Mith tha appropriata 
danaity and laisgth. 



LD8R. Znvokaa tha Liakar/Lpadar 



HHZSK Invokaa tba tlMZSK atility 

that printa tha syvbol tabla. 

PIP Copiaa, eoabinaa, or traaafara 

apaeifiad filaa batwaan 
p«ripharal davicaa. 

SZZ£ZSK Printa tlta siaa a£ a 

CP/M->€OOQ eonund £ila. 

STAT Showa tha accaisa statua for 

di aka or filaa, tha aaount of 
£raa spaca on diaks, tha spaca 
oceupiad by filaa, or tha 
logiczLL -to-physical aaaignaant 
of davicaa, according to 
options apacifiad' In tha 
coaaand lina. 

XSUMP Displays tha haadar contanta 
and synbol tabla ot an object 
or Goausand fila. 
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Tvo Kinds o£ Commands 



Heime 



TnhXtt 4-2. CcontinueKi} 



Function 



Where £xplained 



zee CoBpilar CoBoaxid Interpreter 

ZCCl PreprocttBvor 

ZCC2 Pass 1 

ZCC3 Pass 2 



The C Prograauaing 
Lanouaoe by B.W. 
Kernigh&a and D.M. 
Ritchie, EngJLawood 
Cliffs, SJ: 
Prentice Hail. 1978 



Cr/M-S0OQ Semrebes for 



Skmtm,radtm 



This s«etioQ describe* how CP/M-8000 searches for prograa and 
data fiil«s on disk. You need to understand the steps CP/K-QOOO 
follows, especially if it appear* that CP/M-SOOO cannot find a 
program file you specified with a conaiand keyword in a coMsand 
line. If, for exas^le, you have aorc than one disk drive on 
ycMT systea, the probiea might be that CP/M-8000 is not looking 
on the drive tdt\ere the file is stored. 



Fiadiag Fll«« 



As you reeaii, when you enter a coaaumd line, CP/M-aooo passes 
the consaad tail to the progcan identified by the cosmand 
keyword. If the eonaand tail contains a file specif icatioo 
without a drive specification, the program asks CP/M-SOOO to 
search for the file on the default drive and in the current 
user nujBbar. 

For exajspie, if you enter the following coKBand lines 

3A>DIR MynUB.TaCT 

CP/M-aooo iiJaits its search to user 3, drive A. If MYFILE.TXT 
has the DIR attribute and exists in user 3 on drive A, CP/M- 
3000 confirms the file's existence by displaying the filename 
on your screen: 

A.-iccyiUK.Trr 

Note that the user nunber does not appear in the directory 
Usting. DIH also reports "SYSTEM FII*E(S) EXIST" if user 3 on 
drive A contains files marked with the SYS attribute. 

If ^fY^XLE.TrT has the SYS attribute and is stored in user 3 on 
drive A, DIR merely reports "SYSTEM FILE(S) EXIST" — the 
fiianaJae, MYTII^.TXT, is not echoed to the screen. 

Whether a file is marked SYS or DIR, the search for a file in 
a command tail does not extend beyond the current user number 
and current drive. If CP/M-8000 cannot find the file, the 
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program displays an arror neasaga at the console. Typically, 
this aataaaga is "File not found" or "No File". Which of these 
■essages appears depends on the, program identified by the 
command keyword. 

VlAAiag Psogrma fllmm 

Vfewn searching fior a command file, a?/M--dOOO usee an extensive 
search pattern. This search is laased on your command keyword 
and the filetype, which you might or might ziot supply. . 

Zfi you do add a filetype to your conaand keywordt CF/M-^000; 
first searches the current user number for the command file 
with that filetype. If it cannot find the file in the current 
user number , CP/M-dOOO searches user for the command file 
having the filetype you supplied. 

Z£ you omit a filetype from your command keyword* CP/M-dOOO 
tries to supply one for you based on the fallowing search 
patterns 

m CP/M--dOOO first checks the current user number and drive to 
see if there- is a program file with your command keyword as 
its name and Z8K as its fiXetype* If. this search fails, 
C7/M-^000 then checks to, see if it has a blank filetype. If 
thm filetype is neither ZSK nor blank , CP/MHiOOO then checks 
to see if the prt3gram file has a filetype of san, 

• If the program file ham none of these filetypes in the 
currant user number/ then CP/H<-<a000 checdcs user for the 
same search pattern* first for the ZSK. filetype* then for 
the blank filetype, and finally for the SOB filetype. 

• At any point in the search proeesm* CP/M-4000 stops the 
search if it finds the program file. C?/M-8000 then loads 
the program into aeoory and executes it. Mien the program 
tarainates* CF/M»dOOO displays the system prompt and waits 
for your neirt command. 

e If CP/H<-dOOO does not find the command file, it repeats the 
oommand, follows it with a question nark, and waits fior your 
next command. 

If you include a drive specifier before the command keyword, 
CP/l4--dOOO first looks Cor the program file on the specified 
drive, in the currant user number. If the program file is not: 
found there, CF/M<>dOOO searchea user on the same drive. The 
search goee no fuictjier than this when a drive specifier is 
included in the command keyword. 
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In the exajoxplea used ao fax, CP/M~6000 has executed only one 
coiuaemd at a time. CP/M-8000 can alao execute a liat of 
coaflumda. You can enter a liat of cowmands at the ayatem 
prompt, or you can put a frequently needed liat of comauuida in 
a disk file. Once you have stored the liat in a disk file, you 
can execute the list whenever you need to with a SUBMIT 
command. 

To liat multiple com^ianda in a single command line, separate 
each c om ma n d keyword and command tail from the next keyword 
with an exclamation point (!)• When you coaaplete the liat, 
press R£TUIUi. CP/M->8000 executes your commands in sequence, as 
shown below: 

3A>OISSlDZK Ba>MF*.*lSTMX Jlx 

CP/M-8000 respoox&a to the first of your three comaianda by 
reporting 

UOU-SYSTEM PXI-E(S) EXIST 

Without waiting for any op«r»tor interv«ntioa. CP/M-8000 
executes the second commands 

3A>DIH B6AMP*.* 

A; EJCAMP7 : fflCAMPl TXT : EXAM3?3 ; E3CAMF2 TXT 

A: EXAMP4 : SCAMPS t EXAMP6 

Finally, CP/M-8000 executes the tblrd command in the series: 

3A>STAT Ax 

A: RW, Free Space: 98k 

If you find yourself executing the same command list 
frequently, store the liat in a disk file with a SUB filetype. 
See Section 5 for a description of using the SUBMIT command to 
repeatedly execute a list of commands. 



There night be times when you want to terminate a running 
program before it terminates itself. You can terminate the 
DIR, DIRS, TYPE, and SUBMIT built-in commands and all transient 
utilities supplied with CP/M-8000 (whether invoked singly or in 
a multiple command line) by 3ia^ly holding down the control key 
as you press the C key. In addition, a CTRL-C can terminate 
many of the application programs that you run with your CP/M- 
8000 operating system. 
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If you try to abort a program other than DIR, DISS, Tyl»E, or 
SUailT^ you might experience a delay between the time you preae 
CTR£r-C and the time, the program terainatea. This la because 
CP/H-dCMOO checks for dltlr-C only Mtoen reading from or writing 
to the console. 

Mma you press CTR£i-<; during a program's execution, it causss a 
warm start, sometimes called a warm boot. Ublike other 
versions of CP/M, a warm start in CP/M"dOOO does not reload thm 
opmrating system from your disk back into your ctnputer'a 
asoxry; CP/H-dOOO is always resident in aemory. In CP/H*9000, 
a warm start does two things t it empties that portion of 
aemory occupied by transient utilities and aj^lication 
programs, and it also resets all drives to a Read-writs state. 
At the end of a normal execution of a transient utility or a 
built-in command, CP/M*dOOO performs a warm start. 



^Ghis section describes th« thr*m parts of a file specification 
in a coOTMind lins. to avoid confusion, each part is given a 
^raal name. Th« three parts of a file specification are as 
Allows* 

• drivs specifier is ths optional disk drive A, B, C, ...P that 
contains the file or group of files to which you are 
referring. If a driva specifier is included in your command 
lin«« a colon oust follow it. 



• filename is the one- to eight-^aracter first name of a file 
or group of files. 

# filetypm is th« optional ons* to thre««cbaractar eatagory 

£MUM of a file m group of films. I^e thm filetypa is 
presmnt, a period anst separate it from the filename. 

It you do not include a drivm spacifier, CP/M-8000 
automatically uses the default drive. If you omit the period 
and the filetype, CP/M-8000 asauaes that the filetypa is either 
ZSR, three blanks, or SUB. 
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This generati fora ia called a file specification. A file 
specification identifies a particular file or group of files in 
the directory of the on-line disk as indicated by the drive 
specifier. Par example, 

a:MYTIL£.DA.T 

is a file specification that indicates drive B: , filenaae 
JIYPILE. and file type DAT. File specification is abbreviated to 
siBply 

fi 1ft spec 

in the cosmand syntax stateaants in Section 5. 

Some CP/m-8000 coauaands accept wildcards in the filenajne and 
file type parts of the eommand tail. For axajBple, 

B:My«.A77 

is a file specification with drive sr-*cifier as, filenaisB MY*, 
and filetype A77. This file specification night match several 
filee in the directory. 

Put together, th« parts of a file specification are repreaentod 
like this : 

d ; f ilanaae. ^typ 

where d: represents the optional drive specifier, filename 
repreeents the one- to eight-<:haractar filanane, and typ 
repraaents the. optional one- to three-character filetype. The 
syntax descriptions in thia sMJiual use the tera filespec to 
indicate any valid conbination of the elaaenta included in the 
fils specification. The following list shows valid 

coBbinationa of the eleswnta of a C3>/M-8000 file specification. 

e filenaste 

• filename. typ 

• difilenaae 

• d: filename. typ 

The eivaracters in Table 4-3 have special neaning in CP/m-8000, 
30 do not use these characters in a file specification except 
as indicated. 
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Tahla 4»3. Coaaand Linm Oaliaitflora 



Churactar 


Maaning 


< » - , 1 

?&(> + - 
tab C 3 apaca 
RETOSV kayat:roka 


tiXm spacificatioa daXiaitara 


t 


driva dalioitar in f.ilm spacificatioa 


• 


filatypa daliaiter in Slla 
spacificatioa 


< > 


option list daliaitara* resarved for 
futura uaa 


1 


coaaand saparator 


' C 3 


option list daiiaitars for global and 

loeal optiona 


J 


coaaant daliaitar at tha baginniztg ot 
a coaaand lina 



CP/M-dOOO has •atub.Uahad favaraX fiila groiapa. Tabla 4<-4 liats 
soaa of thair filatypaa witb a «hort daacription of aacb 
faaily. Appwidix S providaa tha eoaplata list. 



TabXm 4-4. CV/M-^aOOO JTllatypaa 



filatypa 



Maaning 



8KS aotiaagaaatad aaawiyblas sourea Cila 

QKS sagaantad aaaaablar aourea fila 

Z8K zaoOO (or aqoivalant aat^ina languaga) «zacu tabla 
program 

C C languaga aotirea fila 

SUB * liat of coaaanda to ba axacutad by SUBMIT 

99$ tanporary fila 
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In some of the commnnd sustm&riea, descriptive qualifiers are 
used in the syntax line with fiiespecs to further qualify the 
type of filespec accepted by the cnumnnds . For example, 
wildcard-f ilespec denotes wildcard spmeif ications, dest- 
filespec denotes a destination filespec. and src-filespec 
denotes a source filespec. 

WLmrmr C^mubuumIs Aire J^mmtapOtMnM. 

In Section 5, CP/M-8000 cojemands appeax alphabetically. 
Section 5 also describes the notation that indicates the 
optional parts of a coBuaand line and ot.ber syntax notation. 
Each coaaand is described according to the following format: 

e The description begins with the cosusand keyword in uppercase. 

e The syntax section gives you one or ware general forms to 
follow when you compose the costsund line. 

• The explanation section defines the general use of the 
command )ceyword# and points out exceptions and special 
cases. The explanation sometimes Includes tables or lists 
of options that you can use in the command line. 

e The examples section lls^s a number of valid command lines 
that u»« the command keyword. 

The notation in the syntax line* describes the general command 
form using these rules: 

• Words in capital letters must be spelled as shown, but you 
czm use any combination of upper- or lowercase letters. 

• A lowercase word in the syntax line has a general meaning 
that is defined in the text. 

e The symbolic notation d;. filename, typ, and filespec have 
the general meanings described in the preceding section. 

e Ycu must include one or more space characters where a space 
is shown, unless otherwise specified. For exewnple, the PIP 
o.ptians do not need to be separated by spaces. 

The following table defines the special syntactical symbols 
used in defining c o a mnn d line syntax. Unless otherwise noted, 
none of these symbols actually appear on your screen ' s command 
liner they exist solely on these pages so that you can see the 
^^ general form of a given command line. Understanding this 
notation helps you form a valid command. 
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Table 4-S. Coawuui Line Conveationa 



Symbol 



Meanlngr 



CI 



() 



f or CTBI* 



<cr> 



7ou caa substitute a nuaber for n. 

You east substitute an option or a list of 
options «> 

You can substitute a strln9« which consists of a 
group of characters, for s. 

Xtests within braces are optional. You can enter 
a coamaadl without the optional iteas. The 
optionai. item add eftects to your c(»unand line. 

Xteaa in square brackets are options or an 
option Hat. It you use an option specified 
within <bhe brackets, the brackets aust enclose 
the option* If the right bracket is the last 
character on the cowaand line, it can be 
OBlttedo These brackets actually appear on your 
Cfwrn anrt line. They have the sane aeaning in a 
era— an d lln« a« they do in the ct^naand suauaary 
earanplee*. 

Zteaa in parentheses indicate a range of 
options* If you use a range frcA an option 
list, you aust enolose the range within 

par Ml theses. 

SUlpses tell you tiiAt the previous itea can be 
repeated any nuaber of tlaws. 

The "or* bar separates alternative iteas in a 
ooaaand line. You can select any or all of the 
altsraatives specified. Mutually exclusive 
qptioas are indicated in additional syntax linee 
or are specifically noted in the text. 

Itepresent the CTSL key on your keyboard. As a 
rule, control characters that do not have a 
coaaand-llne editing function appear on the 
screen with the circuaf lax or caret aymbol ( ' ) 
preceding the letter. Control characters that 
have eoaaand-line editing functions (see Table 
3-L} do not appear on the screen when they are 
executed* 

Indicates a RETUBN or carriage return. In moat 
of the exaaplas In this book, the carriage 
return is iaplied and therefore does not appear 
in the exaaples. 
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Table 4—5. (contixiaed} 



Symbol 



Meaning 



Wildcard character that replaces all or part of 
a filen&Bke or £lletyp«. Appears on your screen 
and has the same asaning as it does in the 
coaaand ausimary exajoplea. 

Wildcard character that replaces any single 
ciiaracter in the sajne position of a filenaae or 
filetype. Appears on your screen and has the 
aaae aeaning as it does in the coaaand sxiaiaary 
exaisplsa. 



Let's look at soae exasiples of syntax notation. The CP/M~8000 
DIE (Directory) coaiiand displays the naaes of files cataloged 
in the disk directory. 

The syntax of tlie DIR coxaand shows how to use the coaaand line 
aryntax notation: 



Syntax: 



Din (d:} i IfilecpecJ 
I I 

optional optional 



This tells you that' the coaaand tail following the coaaand 
keyword DIR is optional- la other words, DIR alone, DIR with a 
filespec, DIR with just a drive specif i«u:. or DIR with a drive 
specifier and a filespec are all valid versions of the DIR 
coaaand. For exaaple. 



DIR 

DIR JOHS.LTR 

DIR B: 

DIR B:JOHN.LTR 

DIR a:JOHN.* 

DIR B:*.LTR 

DIR B:*.* 



are valid commands. The last example, incidentally, is 
equivalent to DIR b:, as shown by the general syntax: 

DIR (d:} I tfilespec} 

These are the only forms DIR can take with respect to JOHN.LTR, 
ax^y file, or no file. Understanding the syntax lets you see 
all the possibilities. 
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The CP/M-€000 command PIP (Peripheral Interchange Program) 
provides an exaApie of a different kind of syntax. PIP can 
copy files from the disk to the screen or printer. PIP can 
combine tnio or more files into one longer file. PIP eaii also 
rtsuun files after cqE>ying thea. All of this iCuoetionality can 
be represented in the syntax < 

PXP des't'*'f ilespee«sre»f ilespeei # f ilespec. . . J 

Xa this example » d«st*f ilespec is further defined as a 
destination file specification or peripheral device ( printer / 
for eacaaple) that receives data. Similarly, src-filespec is a 
source file specification or peripheral device (keyboard, for 
example) that transmits data. PIP accepts wildcards in the 
filename and filetype. See the PIP command in Section 5 for 
details regarding other eapabilitiee of PIP. There are. of 
course* many valid command linee that come from this syntax. 
SosM of them are shown below. 

A>9X9 JUqtiagI L8«D Jtf«<tt'rHATglIi8,aMf 

h>nF BtX.aiS-T.BlS, 2. BBS 
k>WX3f X.aB8wl.Biyi, B«BJIS, C.BB8 
k>WlP BK«4ks*.BlK 
A>VZP Bf-«Bs«.* 

Sad of Section 4 



4-L3 



Secticm 5 

Command Summary 



Ihis ••etion 4lphab«tlcmXly prttsttata thm conuuoda &nd program 
supplied with your CP/H-dOOO operating systam. Aa daacribad in 
Saetioa 4, aaoh ooMHuad saaamxy eontaina a short axplanation of 
tha eoaaaad's opaca-kion and axai^la consand linaa. SD* thm 
CP/!f«dOOO aditor# la daacribad in datalJ. In Saction 6. Ottaar 
CD— inria, such aa ASZ8K and ZdOOO ODT**/ ara daacribad fully in 
tha CP/M-8000 Prograinaar ' a Guida .. 
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COPT (Copy IHmk) 



Syntax: COPY (option list] 

Explanation: COPY copies the contents of one disk onto another 
diak.. It does so on a track -by-trdc)c basis, griving 
you a literal image of the disk or selective part of 
the disk you want duplicated. 

Unlike PIP, which needs to know both the type and 

length of file to be copied, COPY is not sensitive to 
the types of files or their lengths. Even so, COPY 
requires that your destination disk have the sane 
forsBt as your source disk. You sdght have to fornat 
a destination disk b«fore using COPY. Consult the 
docuaentation for your conputer's FORMAT utility for 
details. 

As sho*n3 xa the above syntax, you can type copy and 
then press the RETURH key. This is the simplest foro 
of executing COPY. It is also the aost interactive. 
When you load COPY this way, the following pron^Jt 
comes to your screen : 

Copy Ver 1.1 

A mode menu then appears: 

MODE FUNCTION 

ALL Copy the whole disk 

BOOT Copy the boot tracks 

FILES Copy the non-boot tracks 

£HD End this prograa 

• Choose one mode from the mode menu by entering your 
i;^oice. For example, if you want to copy everything 
on one of your CP/M-8000 disks, easter ALL to copy 
CP/M-8000 ai>d ail files beyond the boot tracks. 
Enter BOOT if you want to copy only the boot loader 
for CP/M-aOOO. Enter FILZS if you want to copy only 
the non-boot tracks. Enter END if you want to leave 
the COPY prograa and return to the CP/M-8000 system 
prompt. 

Once you have selected your mode, COPY prompts you 
with 

Enter SOURCE drive: _ 
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At tho cursor posit lon# typ« a drive letter i>ji the 
range a through p and press the RETURN key. 

SiAilarXy, you see the proapt: 

Enter OESTTHAItZON drive* _ 

Reply with a drive letter in the range A through P 
and press the RETORS Icey. COPY pronptst 

("C to A£ORT) 

RETURN to copy <aode> froa <source> to <destination> 

Mode* source* and destination have actual values on 
your screen in place of the words shown here. If 
these are the values you truly want COPY to use, 
press the RETURN key. COPY begins copying at this 
point* as indicated by the aessage« 

•♦♦Copying nn Tracks •*♦ 

that appears at the bottom of your scre«ui. The nn in 
this proaqpt stands for the aettuUL track numbers 
curr«Eitly being c^ied. 

If you decide to abort the copy process # type CTBL-^ 
(that is* hiold down the Control key and press the 
letter C} . Zf you have not used the [A] (for 
autoaatic) option when *you were at the CP/M~dOOO 
coaaand line* then yiM are offered a chance to do 
SOB* aore copying when COPY finishes your first copy. 
COPY saves the paraautters you gave it for the last 
copy just aade; then COPY asks you: 

Oo ycni wish to repeat the copy? _ 

Type T if you do* If if you do not. Zf you type H* 
the COPY program «nd8 without any further processing 
and returns you to the CP/M~6000 systea pronpt. If 
you type Y* COPY ahowe you the valuee used in the 
last copy session and invites you to start another 
copy session by entering a carriage return. For 
exaaple* if y<^ chose mode ALL* source driv9 A* and 
destination drive 3 in your initial copy session, 
COPY returns the following proapt for all subsequent 
copy sees ions < 

(*C to ABORT'> 

RETURN to copy ALL froa A to B 

If you decide at this point not to begin a new 
session* type CTRL-C. CTRL-C returns you to the 
CP/M-dOOG systea pro^t. 
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Instead of typing COPY ind pressing the RETURN icey at 
the proB^Jt, you can supply your copy options before 
COPY is Loaded and executed. However, if you take 
advantage of this shortcut, you must present your 
options in a certain order. The order for COPY 
options is : 

I mode qpttion] before 
[source drive option] before 
(destination drive option) before 
(autonatic carriage ratum option] 

and/or [verify option) before 
[n&nual carriage return} 

Exaiaples: Soae representative coabinations of the COPY contemnd 

line appear beiow. With the exception of the A and V 
options, which are discussed below, each of the 
options in the above ezasiples is explained in the 
preceding basic, interactive COPY session. 

COPY Ml, 
COPY ALL A 
COPY ALL A B 
COPY ALL A B [A} 
COPY ALL A B [Vl 
COPY ALL A 9 [AV] 

COPY A 
COPY B 
COPY CA] 
COPY [V] 
COPY Cav3 

COPY A B 
COPY A B Ikl 
COPY A B CVJ 
COPY A B CAV3 

Hotsa Be sure the source drive appears to the left 
of the destination drive in your option list, tf ywa 
inadvertently get the drive letters of your 
destination drive and source drive turned around in 
this option list, you will copy your destination disJc 
(probably blank) on to your source disk, thereby 
wiping it out. To avoid this, always enter the 
source drive letter bafore you specify the 
destination drive letter, them recheck what you've 
typed before pressing the RETURN key. 
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The Ca3 option acts as a virtual RETUHN key a4i. run~ 
tine. You usually would be required to set the copy 
process in motion once the parameters have been 
supplied to COPY. Specifying C^] allows the copy 
process to execute withotat interruption and without 
finrther opmcz.tox interaction. 

The CV] option involcee COPY'S verification option. 
I9h«a you use the CV]« COPY compares the data on 
source and destinaticm disks following a copying 
operation to verify that the data on the two disks 
are the same. COPY with CV] ruxts more slowly than 
COPY without i;v3. This is because Cv] demands that 
COPY go through extra steps in reading the 
destination disk and cosparing its data to the data 
on the source disk. 

If you enter more options in the option list than 
CCPY MMmm, those extra options are thrown away. For 
exaaqple* if you type 

k»Can P£UBS h 'B WlfftT/> TBZBS 

th# COPY utility loads and then displays the message t 

SaEtzaneoum argcuB^nt ignored! hello 
laetzaniKaas arguwtnt ignored i there 
("C to ABOIW) 
BSTOiOr to copy ytTiB3 from A to B ^ 

Tbua* COPY hmlpe salvage the copy session for you by 
allowing ymx to either abort COPY or else eontixwe 
with the copy process, using the. only three valid 
options it found from the command line in this 

Le. 
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DOL «a«l DISS Coi 



Syntaj:: DIR (d: } 

DIR (filespttc) 

DIRS Id:} 

OIRS (£xlesp«c} 

Sxplanation: The DIR and DIRS built-in conaiands display the naaet 
of fil«« contained in th« directory of an on-line 
disk. 

The DIR coBan&nd Lists the naaes of files in the 
current user nuaber that have the Directory (DIR) 
attribute. The DIRS comn&nd displays the naiies of 
files in the current user nuiober that have the Syetsa 
(SYS) attribute. 

All azacutable files in user 0, regardless of their 
SYS or DIR attribute, can be executed in any user 
nusiber. Bo**ever, you aust be in user to display 
those files with DIR or DIRS. 

I£ the drive and file specifications are oaitted* the 
DIR consand displays the naaes of all files with the 
DIR attribute on the dis); in the default drive and 
current user nunber. In the saaw way, DIRS displays 
the SYS files. 

If the drive specification is included, but the 
filenajoe and filetype are oioitted, the DIR coBOiand 
displays the naaes of all DIR files in the current 
user nujnber on the disk in the specified drive. DH^S 
displays the SYS files. 

Both DIR and DIRS accept wildcard filenanes and 
filetypes. When you use wildcard characters, all 
filenaa*BS that satisfy the match are displayed on the 
screen. 

If no filenastss natch' the file specification, or if 
no files are cataloged in the directory of the disk 
in the naaed drive and user nuaber, the DIR and DHIS 
cosimands each dLisplay the message: 

No Pile 
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I£ SYS files that reside on the specified driv^ and 
user number match the file specification, OIR 
displays the message t 

SYSTEM FILS(S) QCIST 

If DIR files match the file specification* D2ES 
displays the message t 

lON^SYSTSM FXL2S(S) SQST 

The S7S and DIR attributes aare described under SSKX 
later in thiji section. 

Sxaapleat Tttm foLLotfing example displays all DIR files cataloged 

in user on the default drive A. 

Jk>OIR 

The follotfiii.g.ccnDBaad displays all SIR files for user 
oda drive 3. 

\>02R Bi 

The next command displays the name X.BAS if the file 
X.BAS is present for user (m drive B. 

A>OXX B«X.aAS 

The next command displays all OIR files vrith filetype 
aJkS for user 4 on drive A. 

4A>0ZR *.BA0 

The following command displays all OIR files for user 
on driv« A whose filenasM begins with the Setter X* 
and \thoum three character filetype contains the first 
character C and last character 0. 

B>OZR AsX*.C7X> 

The next eofflsand displays all files for user on 
drive A that have the SYS attribute. 

A>OXBS 

This wildcard form of the DIRS command displays all 
SYS files with the ZSK filetype on the default drive 
A for user 3 . 

3A>0XRS *.ZaK 
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ED (Ciuurmeter FUe EiUtor) C«mmjuaidl 

Syntax: ED input-f iiespec Id: I output-f ilespec} 

Explanation: The ED transient utility let* you create and edit a 
disk file. 

The ED utility ia a line-oriented context editor. 
This means that you create and change character files 
line-by-line, or by referencing individual characters 
within a line. 

Thm ED utility lets you create or alter the file 
naoed in the file specification. Please refer to 
Section 6 for a detailed description of the ED 
utility- 

The ED utility uses a portion of your couputer's 
aexBory as the active text buffer, a )cind of teBpor&ry 
storagil area where you caA add, delete, or alter the 
characters in thm file. Use the A connand to read 
(Append) ail or a portion of the file into the 
buffer. Use the W coauB&nd when you want to write a 
portion of the file's contents froB the buffer back 
into the file. The E coamand is used to write the 
entire contents the buffer back into the file and end 
the ED session. 

An imaginary cha.racter pointer, called CF, is at the 
beginning of the buffer, between two characters in 
the buffer, or at the end of the buffer. 

You interact with the ED utility in either comnaad or 
insert mode. ED displays the * proapt on the screen 
when BD is in conmand oode. Vfrien the * appearsr you 
can enter the single letter conmand that reads text 
from the buffer, aoves the CP, or changes the £33 mode 
of opezration. When in coimaod aode, you can use the 
line-editing characters CTRI/-E, -a, -O, -X, and 
RUBODT to edit your input. In insert node, however, 
you can use only CTRL-H, -U, -X, and RUBOOT. 
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T&bltt 5-1. ED CoBwuid SuaoHury 



Coimuiiid' Action 



aA 



Append n lin(*« £roa oclginal fill* to 



OA 



AEp«nd fill« until touif «c is on« half 
full or until •nd ofi input is 
r«ach«d. 



«A 



AppMnd fill* until bu££«r la full (or 
mtd of fil«) . 



•1# .-•B 



Htprsfm CP to beginning (B) at bottov 
(«B) of buff ax. 



aC# *iiC 



Mev« CP a (Shazmctara forward (C) or 
baoK <-C) through buffar. 



nOf -oD 



Dalata n chacactara bafora (--O) or 
aftar (0) tha CP. 



Sava na%« tila and ratum to CP/H- 

aooo. 



P»tring{T2) 



Find charactar string. 
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Tzdale S-I. (contiiziued) 


Command 


Action 


B 






Save the new file, then reedit, 




using the new file as the original 




file. 


I 






£ntar insert node; use TZ to exit 




insert mode. 


Istriixg' 


T2] 


1 


Insert string at CP. 


Jsear^^ 


_Btr*2in8^8tr*Zdel_to_strlT2] 




JuztapocB strixigs. Juxtaposition 




does not support a repetitive 


■ 


execution of juxtapose on a single 




command line. 


nK, -aK 






Delete (kill) n line« from the CB. 


oL, -oL, 


OL 




Move CP n lines. 


aMcommands 




Execute commands n times. 


a, -n 






Move CP n lines auad display that 




line. 


n: 






Move to line n. 
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'tabl* 5-1. (contiimvd) 



'^'711*'*"^ Action 



I iini >iimnni1 



Bx«out» coaaaad through Iln* a. 



HstxiagitZ} 



Ext«nd«d find string. 



mSf, -*nF 



R«tum to original fil*' 



Mov« CJ a •p«g««'' forward or 
backward (-P) ia tha buffar and 
display n pagas on tha conaola. A. 
paga aqEuaJUi 23 linaa. 



Abandon turn i±lm, ratum to CP/M- 
3000 . 



R 



Raad X$$9$$9$ .LZB £ila into buffar. 



SfllaapaoitZ} 

Raad filaspae into buffar. 



Sdalata atring^Zinaart •tringCTZl 
Subatituta string. 



aSCt -nT, OT 



Typa a linaa. 
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Taibltt 5->l. (contixmed) 



Comannd 


Action 








u. 


-U 


Oppercase translation. 






V, 


-V, OV 


Lin« nuabaring on/o££, display 
buffsr space. 


free- 


nW 




Write n lines to 


new file. 






nX 




Write or app 


end n lines 


to 


ziXfilcvpaclTZ) 

Writ* n Xines to filesp«(c or 
1£ prsrlous X coissi&nd applied 


append 

to the 


OX 




Delete file X$$$^$$^ .LIB. 






OXf 


ilespttc 


(T2) 
Delete Sllespee. 








nZ 




Wait n seconds. 


• 
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ER^Cai 



Syntax t 



SR^ (filAspttc) 



Sxplanationx Th« ERA conuund r«sov«s oa<a or aor* £il«s txom th« 
directory of « dlak. wildcard charactars ara 
aecaptad in tha iiXmttpma. Oiractory ajud data apaea 
axtt autonatically raclalaad for la tar uaa by anotiiar 
fila. 

qaa tha SUA connaxid with cara bacauaa all fllaa that 
satia£y tha £ila apacifieation ara raaovad froa tha 
disk diractory* 

Cosaand linaa «fith tha foras 

EBA (dtlwlldcard-filaapac 

raqaira your eonfiraation bacauaa thay araaa an 
antira group of fllaa# not juat ona fila. Tha ayataa 
will proapt you for eonfiraation with tha following 
aaaaagax 

Confirm (Y/H)? . 

Raapond with T if you want to raaova all matching 
filaa* and M if you want to avoid araaing any fllaa. 

thara ia ona inatanea in whi^ tha SRA eoaaand with a 
wildcard do«a not cauaa tha ayataa to pro^t you. In 
a SOBMZT fila* whan you uaa a wildcard with an KA 
coaaand. C3?/tf-d00a doaa not aak for confirmation. 
Flaaaa saw saSHTS latar in thia aaetion. 



If no filaa aateh tha fila specif i<3ation. you 
following naaaagas 

Cto Fila 



tha 
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Sxaiopies 



Thia conaand reiaove the file X.PAS from the disk in 
user on drive A.. 

A>EBA Z.PAS 

To delete ail file with the file type PRN from the 
disk in drive A, ua< 0, enter the following coaaand. 
You see the system equest confirmation : 

A>SRA *.FRH 

Confirm (y/N)7T 

The next ex&i^le re leets that all files on drive £, 
user 5, be removed rom the dialc. 



Confirm (Y/H)7T 
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FXPCoi 



Syntttxs 



PIP 6mat'tilmiZ<in2) I dev-ece-fileitd]} i deviCo]} 



Sxplaxuitions 



Ihe.PXP utility copies one or aoxe fiXee txom one disk 
and/or user auiaber to another. PIP can rename a file 
after copying it. PIP can coebine two or more files 
into one file* PIP can also copy a character file 
from disk to the printer or other auxiliary lo9ical 
output device. PIP can create a tile on disk from 
the console or other logical device input. PIP can 
transfer data froa a logical input d»vice to a 
logical output device. Sence the nane Peripheral 
Znteirebange Program. 



mjagXe Wi,2M '030|f 



iyntapBs 



WIP At ( Cin3 ) * so«iree*f ilespee ( Captions] } 

PXP dest'>fil««pe<3i£<tel} * ds (Captions]] 

PIP dest^illespeeCConJJ ■ soure*"filespec{Co]} 



Sscp lanat ion t 



iihe Cirat iorm shows the aiiqpleet way to co^ a file. 
PIP ICNoka tor the file najsed by soure entile spec on 
the default dr ^tiooally specified drive. PIP 
copies the file to the drive specified by di and 
fives it the sasa aaae as souxesr-filespee. %bu can 
us« th* C<ki3 option to place your destination file 
(dest*filsf«pee) in tis* user nuaber specified by a. 
"Ihe only option recognized for the deetination file 
is C<3h]* Several options can be coabined together 
for the source file specification ( source-file spec ) . 
PIP'S options are fully deeeribed below. 

The second fora is a variation of the first. PIF 
looks for the file naaed by dest-filsspec on the 
drive specified by ds^ copies it to the default or 
optionally specified drive* and gives it the same 
naae as dest-filespee. 



S-IS 



C?,/M-8000 User's Guide PIP Conuaand 

The third form shows how to renaae the file after you 
copy it- You can copy it to the same drive and user 
number, or to a different drive and/or user nuBtber. 
Rules for options are the same. PIP looses for the 
file specified by source- file spec, copies it to the 
location specified in dest-f ilsspac, and gives it the 
naAe indicated by dest-filespec. 

RaAember that PIP aJLways goes to and gets from the 
current user nunber unless you specify otherwise with 
the [Gn] option. 

Before you stiart PIP, be sure that you have enough 
free space in kilobytes on your destination disk to 
hold the entire file or files that you are copying. 
Even if you are replacing an old copy on the 
destination disk with & new copy, PIP still needs 
enough rooa for the new copy before it deletes the 
old copy. See the STAT command in this section. 

Data is first copied to a teBporairy file to ensure 
that the entire data file can be constructed within 
the space available on the disk. PIP gives the 
temporary file the filename specified for the 
destination, with the fiietype $$$, If the copy 
op«u:ation is successful. PIP changes the temporary 
fiietype SS^ to the fiietype specified la the 
destinatioa. 

If the copy operation succeeds and a £ll:e with the 
same najse as the destination file already exists, the 
old file with the same name is erased before renatting 
the temporary file. 

File attributes (SYS, DIR, RW, RO) are transferred 
with the files. 

If the existing destination file is set to Read-Only 
(RO), PIP asks you if you want to delete it. Answer 
Y or 41. Use the W option to write over Read-Oniy 

files. 

You can include PIP options folicM^ing each source 
name (see "PIP Options" below). There Is one valid 
option, [Gn] (go to user number n) , for the 
destination file specification. Options axe enclosed 
in square brackets. Several options can be included 
for the source files. They con be packed together or 
separated by spaces. Options can verify that a file 
was copied correctly, allow PIP to read a file with 
the SYS attribute, cause PIP to write over Read-Only 
files, cause PIP to put a file into or copy it from a 
specified user nuaber , transfer from lower- to 
uppercase, and much more. 
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Exaoplas: Both of the following forms of this command caufe PIP 

to read the file OLDfILE.DAT from drive A and put an 
exact copy of it onto drive B. This is called the 
short fora of PIP^ because the source or destination 
naaea only a drive and does not include a filename. 
Vkma usilng this form* you cannot copy a file from one 
drive ax&d user mxaJber to the same drive and user 
number. You must put the destination file on a 
diifereat drive or In a different user number. See 
the section <m PIP Options, and the^^attction on the 
tISSR couuind* The second short form produces exactly 
the same result as the first one. PIP simply looks 
for the file OLDFXLE.DAT on drive A. the drive 
speolfied as the source. 

A>PXP Bi-4UOL0rXLE.fiAT 

A>FXP aiO(L»rZL8.i3AT-iAs 

thm lolloiflng Cfamand oqpies the file OLDFILE.DAT 
from drive A to drive B and renames it to 
newflXe.dat. The file remaina as OIJDFILS.QAT on 
drive A. 'Shim is the long form of the PIP command, 
beeause it aamis a file on both sides of the couumd 

CTsiiig this long form of PtP, you can copy a file from 
one drive and user number ( usually user because 
CP/M-dOOO atttoaatically starts out in user 0, the 
default user number) to the same drive and user 
xambmg* This effectively gives you two copies of the 
same file on one drive and user number* each with a 
differant nasMt. 

The following command copies the file PHOdRAM.JDAT 
from user 1 on drive A to user on drive B and 
renames this filetype on drive B* user 0. to BAK. 

A>PX9 atPB06BAII.BAK » A«PB06BAM.JU^C<313 

In the next, command, PIP copies the file named 
PROGRAM!. OAT on drive A and echoes CS] the transfer 
to the console* verifies CV3 that the two copies are 
exactly the same* and gets C<33] the file programl.dat 
fre» user 3 on drive A. Because there is no drive 
specified for the destination* PIP automatically 
copies the file to the default user number and drive. 
in this case drive B, user 0. 

3>pip PBOGBAM2.DATi>AsPROGRANl.DATCB V G3] 
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Multiple Pii© Copy 

Syntax: PIP d:(C<3n3] - ( d :} wildcard-file 8p«C t [o] ] 

Explanation: Vtoen-you use a wildcard in the source specification, 
PIP copiee qualifying filee one-by-one to the 
destination drive, retainin? the origlaal naae of 
each file. PIP displays the aessage, COPYING, 
listing each filename as the copy operation proceeds. 
PIP issues an error massage and aborts the copy 
operation if the destination drive ackd user nunber 
are the sane as those specified in the source. 

Sxanples: The following coBxaand causes PIP to copy all the files 

on drive A with the fiiatype GSffl to drive B. 

A>PIP B»"*j*.CKD 

The next coasand causes PIP to copy all the files on 
drive A to drive B . You can use this coBBtand to sake 
a backup copy of your distribution disJc. Note, 
however, that this coaosand does not copy the CP/M- 
aooo bootstrap loader from the systea tracks. COPY, 
car any other track-to-track copy prograa, copies the 
systea tracks for you. 

A>PIP Bt-Aa*.* 

The coajBand below causes PIP to copy ail files 
beginning with PROG and having any filetype firoa 
drive A to drive B. 

A>PIP BiWuFBOGTT??.* 

The following conmawi causes PIP to copy all the 
files with a filetype of HAS on drive A in the 
default user nuaber, user in this case, to drive 'B 
in user nuatoer 1. Reaeaber that the DIR, TYPE, ERA 
ard other coaaands only access files in the saae user 
nuaber froa which they were invoked. See the USER 
coBBand. 

A>PIP B«CGa.3-A.!*.BAS 
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Cowtoining Filas 

Syntaxs PIP d«st-fiil«{CGaJ}«>«rc-£il«iCopt3}, f.il« 
[Copt3J{.fll«{Copt3J.,.J 

Baqplaaatioax this fom ot th« PIP coiuMnd lata you specify two or 
aor« £il«a In the aourc*. PIP copi«« th« fiiJLus 
sp«cifi«d in th* souro* froa I«£t to ri^h^ and 
caal3in«s th«a into on* fil* with th« naoa ixMiieiitad 
by th« d««tination £il» sp«ei£ication. This 
^oe«dur« la callad £il« concatsnation. You can uaa 
th« CGaJ option a£tar th« daatination £iX« to pXaea 
it in tha user nuabar apacifiad by n. You can 
apaclfy ona or oora opticma £oc aach sourca £ila. 

Most o£ thii optiona £orca PIP to copy £ilaa charactar 
by eharmotar. In thasa casaa PIP looka £or a CTBL-Z 
ehacaotar to dataraina tha and of tha £ila. Ail of 
thm PIP options £orca a charactar transfar ase^rt tha 
foilowiiif : 

<kkt Kt Or Rf V, and W* 

Gosyinf data to or ixom logical davieaa aiao £orcaa a 

^lanietar ;t£ansfar. ' 

l^ing c^utraotar trans far a » you can tarainata a £ila 
eoaeataaation oparaticm by prassin? CTBL-k:. 

>ihan concataiiatihg £ilas« PIP aaarchas cmly tha last 
racord of a fiila for tha CT&L-Z and-of-fila 
chaxaetar« How«var# If PIP is doing a charactar 
txauBiafar. it atopa t#han it aneountars a CT8L*Z 

dtuutaetar. 

XIaa C03 if ym ara coacatanating aachina coda filaa. 
C03 causas PIP to Ignora an aabaddad CTIU>Z (and^-of- 
fila) <:diaraetar, vihich uaually indicataa tha «id-of«» 
fila charactar in a fiila. 

Sxaaplass Tha following thraa £ilaa naaad FILSI, PILS2, and 

PILS3 ara joinad £roB laft to right and copiad to 
HENPILS. $$$ . 13EWFILE.^$$ ia r«iaaad to tIEHFILS upon 
auccaaaful coaplation of tha copy oparation. All 
aourca and dastination fiilaa arm on tha disk in tha 
da fault driva A. 

A>pip aEmwxLs^wiLSi^nua, FILES 
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In the next example, the file Y.ASM on drive A is 
joined with Z.AjSM from drive B and placed in the 
temporary file X. ?$? on drive B. The file X. $5$ is 
renamed to X.ASM on drive B when PIP runs to 
successful conplation. 

A>PXP EiX.ASm - T.AJ5M. BtZ.ASM 



Copy Files to and from J^uxiliary Dwiccia 



Syntax 



PIP dast-filttspec {CGq,3J 
AXOi 
COS 
PRN 

LST 



■ source-f ileapec lCo3J 



AXI 
CON 
£7UL 
EOF 



I [options] } 
[[options ]} 



Explanation: 



This form is a special case of the PIP commajnd line 
that lets you copy a file from a disJe to a device, 
from a device to a disk, or from one device to 
another. The files must contain printable 
ciiaracters. Sacb p»eriph«ral device is assigned to a 
logical name that identifies a source device that caxi 
transmit data, or . a destination device that can 
receive data. A coloa follows each logical device 
n&BM BO it caxinot be coafuaed with a filename. Press 
CTKL-C to abort a copy operation that uses a logical 
device in the source or destination. 

The logical device naJMs are listed as follows: 

CON: Console is tbe physical device assigned to CON. 
When used as a source, usually the keyboard; 
when used as a destination, usually the screen. 

AXI: Aujciliary- Input or Output Device. 

AXO: Auxiliary Output Device. 

LST: The destination device assigned to LSI, usually 
the printer. 
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Thera are thraa devic« naaea that have splWcial 
fflttaning : 

IiIUL< A virtual sourc* d«vie« . that produces 40 
h(ucad«ciiBal zeros* 

EOFs A virt:ual source device that produces a single 
CTSL-Z* the CP/M-dOOO end-of-£ile oarlc. 

PRBs The printer device with tab expansion to every 
eighth eoluna. line auo&ers, and page ejects 
every 60th lins. 

Sxaaplesi In the following exasiple* characters are first read 

froa the console input device, generally the 
keyboard* and sant directly to your printing device. 
You typi a CTBLr-Z character to tell PIP that Iceyboard 
input is coaplete. At that tiae* PIP continues by 
reading character data firc» the file MYDATA.DAT on 
drive a. Sacausa PBlft is the destination device, 
tabs are expanded* line nuatt»ers aure added, and pa^ge 
ajecta oeieur every 60 lines. 

i»PXP PBf««CQIIt,Jfn»S9U2!Ua 

If CSTi is assigaad to CCOrs , whatever you type at the 
CQoaola is written to tha file BOTES. aSS on drive a. 
Tou aust press tha RETOBH key amd the Iina->fead key 
(or CTRL-J) to cosuBit your input to the file. End 
tha kayboand input by typing a CTRIr-Z. Corrections 
oi previously typed aaterial are not paraltted in 
this option. 

A>PZP BtJiOfB3.(3XB«COtl< 

t£ CRTs is assigaad to COHc aa in the followii^ 
axajq^la* w^&tavar you type at tha keyboard is written 
to the list davica# generally tha printer. Terminate 
input with a CTHIr-Z. 

A>91? LSTi'KXMt 

In the following exaaplef the file DRAFT. TXT on drive 
a is written to the printing device. Any tab 
characters Jire expanded to the nearest coluan that is 
a Boltiple of 3. 

A>PXP LST3«B<ORAVT.T3CTCTa3 
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The command below causes PIP to write the file 
DRAFT.TXT to the list device. It automatically 
expands the CAbs, adds line numbers, and ejects pages 
after sixty lines. 

A>PIP PBH:-B: DRAFT. TXT 

The PIP options S (Start} and Q (Quit) search only 
for uppercase character strings whan you enter PIP 
tsom the CP/H-SOOO connan^ line. This is because the 
CCP automatically converts the command line to 
uppercase. I£ you want to search for a lowercase 
string/ you must use PIP's interactive mode. 

The following command causes SOTS.. TXT to list at ths 
console, COU: starting at the first occurrence of 
B£GI22NI»G. 

A.>FXP CCm:«-EiOTE.'CrrCS BBSXBSXBG'Z] 

The CCP converts beginning to BSGHZHIHG, if you enter 
the following command line. 

A>PIP con t -MOTE. TTTCS b«gtaiuj!ig"Z3 

Because PIP cannot find BEGZHNXHG in the file 
^TE.TXT, you receive the follo«(ing message: 

EHROR: START HOT TOUKD 

To avoid seeing this messiage, eater the Search option 
at the PIP prompt. 

A>PIP 

•COS: "BOTE. tXXCS b<>ginr,xpg*23 

Also use pip's interactive mode wh«n spetcifyiog Quit 
strings with the Q option. 
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HouLtipl* Co— iinri Mode 

Syntax > ?IP 

Ejqplaimtloas This £brm o£ tbm PIP aonund' atarta tha PIP utility 
«ttd l«t« you typ* aultipXa coaaand linas whila PIP 
raaains in ojiar aaaory. ^ 

REP writaa aa aatariaJc (•) on your acra«a whan raady 
to aceapt input eoaaand linaa. 

7ott can typa any valid coaaand lina dascribad undar 
pravioua PIP formats following tha aatarisic prompt. 

Tarainata PIP toy praa«ing tha RETaUK kay following 
fe^ itatariak proapt. Tha aapty eoaaand lina tails 
PIP to dliacontiima operation and ratum to tha CP/M- 

WiQ iyataa proapt. 

Bxaaqplapa tha fioLIowlag ooaaaad loads tha PIP program. Tha PIP 

• ooaaand ii^ot proapt (♦) tails you that PIP is raacty 

to aeeapt opaasnda* Tha affacts of this aaquttca o£ 
eoaaaads >r« tha sama as shown in tha pravioua 
mamm^L^m, whara tha coaaand tail is included in the 
ooaaand line. PIP is aot loaded into aeaory for aach 
coaaand. 

A>ffXP 

•Apsoa. GMD-B9ae». am 
*iu«Hisx.Aai 



(teiav Optioaa w itli PX» 

Saeplaaations Options enable you to proceaa your source file in 
special way a. You can expand tab characters, 
translate from upper to lowercase, extract portions 
of your text, verify that the copy is correct, and 
aueh aore. 

PIP options are listed below, using n to represent a 
nuaber and s to represent a sequence of characters 
terminated toy a CTR£f-2. An option must immediately 
follow the file or device it affects. The option 
must be enclosed in sqtaara brackets, C]. For those 
options that require a numeric value, no blanks can 
occur between the letter and the value. 

5-23 



C? M-aooo User's Guide 



PIP Command 



You can include the [Gn] option after a destination 
file specif icatioa. You can include a list of 
options after a source file or sonrce device. An 
option list is a sequence of single letters and 
numeric values that are optionally separated by 
blanks and enclosed in square brackets. C3. 



TaJsle 5«2. PXP Optioosi 



Option 



Function 



Dn 



Gn 



Delete any characters past column n» 
This parameter follows a source file 
that contains lioss too long to be 
bandied by the destination device, 
for example, an 80-ch&xacter printer 
or narrow console. The number n 
should be the naxiaua column width 
at the destination device. 

Echo trimsfer at console. When this 
parajbeter follows a source name. PIP 
dijrplays the source data at the 
ccoxsole as the copy is taking place. 
The source must ccsntain. character 
data. 

Filter fora feeds. When this 
pexa&eter followi a source name, PIP 

reaoves all form feeds embedded in 
the source data. To change form 
f e e d s set for one page length in the 
source file to another page length 
in the destination file, use the F 
command to delete the old form feeds 
and a P coouumd to simultaneously 
add new form feeds to the 
destination file. 

Get source from« or go to user number 
n. When this parameter follows a 
source name. PIP searches the 
directory of user number n for the 
source file. When it follows the 
destination name, PIP places the 
destination file in the user number 
specified bj' n. The number must be 
in the range to 15 . 
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Table 5-2. (continued) 



Option 



Function 



H 



Bmx data transfer. PIP checks all 
data for proper Intel* hexadecimal 
file format. The console displays 
error aessages when errors occur. 
This function is included for 
historical reasons only. 

Ignore tOO recc^ds in the transfer ot^ 
an Intel hexadecimal format file. 
The I option automatically sttts- the 
a option. This function is included 
for historical reasons only. 

Translate uppercase alphat>etics in 
the source file to lowercase in the 
destination file. This parameter 
follows the source device or 

lilenaiMi. 

Add line numbers to the destination 
file. Vfhen this parameter follows 
.t;tLm source filenam*. PIP adds a line 
iOMEnber to saeh line celled, starting 
with 1 and incrementing by one. A 
colon follows the line number. If 
112 is specified. PIP adds leading 
seroa to the line mimber and inserts 
a tab after the number. If the T 
pmr««eter is also set, PIP expands 
th« tab. 

jabteet file transfer for machine code 
4 no a char act er and therefore 

DOQpcintable) files. PIP Ignores 
any <STHI«-Z end~of*file during 
concatenation and transfer. Ose 
this option if you are combining 
object code files. 
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Table 5-2. ( cont-inued ) 



Ootion 



Function 



Pn 



a« 



Ss 



Tn 



Set page length. n specifies the 
number at lines per page. When this 
parameter modifies a source file, 
PIP includes a pvage eject at the 
beginning of the destination file 
and at every n lines. If d"1 or is 
not specified, PIP inserts page 
ejects every 60 lines. When you 
also specify the P option, PIP 
ignores form feeds in the source 
data and inserts new fora feeds in 
the destination data at the page 
length specified by n. 

Quit copying from the source device 
after the string s. When used with 
the S parameter, this parameter can 
extract a portion of a source file. 
The string argument must be 
terminated by CTKIr-21.. 

Read system (SYS) files. Usually, 
PIP ignores files marked with the 
system attribute in the disk 
directory 1 but when this parameter 
follovB a source filename, PIP 
copies system files, including their 
attributes, to the destination. 

Start copying from the source device 
at the string s. The string 
argument must be terminated by CTBlr- 
Z, When used with the Q parameter, 
this parameter can extract a portion 
of a source file. Both start and 
quit strings are included in the 
destination file. 

Sxpand tabs. When this parameter 
follows a source filename, PIP 
expands tab (CTHL-I) characters in 
the destination file. PIP replaces 
each CTKIr-I with enough spaces to 
position the next character in a 
column divisible by a. 
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Tabla 5-2. ( continued } 



Option 



Function 






Translat* lowercase alphabetic 
characters in the source file to 
ccppercase in the destination file. 
This parameter followe the source 
device or filenane. 

Verify that data has been copied 
correctly. PIP compares the 
destination data to the source data 
to ensure that the data has been 
written correctly. The destination 
nast be a disK file. 

Mrite ever files with RO (Read-only) 
attribute. Usually, if a PIP 
qoMand tail includes an existing so 
file as a destination* PIP sends a 
query to the console to aake sure 
yoa want to write over the existing 
.file* Hhen this parasMter followe a 
•ouroe naiM* PIP overwrites the RO 
file without a console exchange. If 
the eoaaaad tail contains aultiple 
source . files* this parameter need 
only tol4>Ow the last file in the 
list*' 

SerOf the parity bit. When this 
parameter follows a source naiMf PIP 
sets the parity bit of each data 
byte in the destination file to 
aero. The source aust contain 
dtiairaeter data* 



Sxampless 



The following command ctmstruets the file tiSWPROG. bas 
on drive A \sy joining the two files CODE. BAS and 
DATA. BAS from drive A. During the copy operation, 
CODE. BAS is translated to lowercaser while DATA. BAS 
is translated to uppercase. 

A>PXP lOEMPBOO.BAS-CODB.BASCLa, 'dAZA.BASCU3 

The next command writes the character file 
WIDEFILS.SRC from drive A to the console device, but 
deletes all characters following the 30 th column 
position. 

A>PIP CQIf«-WXSBFZLS.SBC£l»03 
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In the next example, the file LETTER.TXT from drive A 
is copied to LETTER.TXT on drive B. The LETTER.TXT 
file i« aiao written to the screen as the copy 
operation proceeds. 

A>PIP Bj-LETTEE-TXTCE] 

The next command writes the file LOhJGPAGE.TXT from 
drive B to the printer device. As the file is 
written, form-feed characters are removed and 
reinserted a't the beginning and every 65th line 
thereafter. 

A>PIP LST:-BsLOHGPAGE.TrTCFP65] 

The next conaand writes the file PROGRAK.ASM from 
drive B to the printer device. The N parameter tells 
PIP to number each line. The T8 parameter expands 
tabs to every eighth column. The U parameter 
translates lowercase letters to uppercase as the file 
is printed. 

B>PIF LST:«PBOGBAK.AEMCgT8133 

The following command extracts a portion of the 
LETTER. TXT file from drive A by searching for the 
character sequeoce "Dear Sir" before starting the 
copy operation. When found, the characters are 
copied to PORTION.TXT on drive A until the sequence 
"Sincerely" is found in the source file. Note that 
this PIP optica can only be used when PIP i« in the 
multiple copy mode with the asterisk prompt, even if 
you do not intend to make multiple copies. This 
option cannot be used in single copy mode on the same 
lino a» the PIP command keyword. 

A>PIP ^ 

•PoanOH-TXT-LETTER-tXTCSDekar Sir "2 QSinceraly Zj 

The next command copies ail files with filetype CMD 
from drive A to drive B. The V parameter tells PIP 
to read the destination files to ensure that data was 
correctly transferred. The W parameter lets PIP 
overwrite any destination files that are narked as RO 
(Read-only). The R parameter tells PIP to read files 
from drive A that are marked with the SYS (System) 
attribute . 

B>PIP Bs-Ai*.atDCVWBj 
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Syntmxs RJBS (n«M-£ll««p«c«old-fil«sp«e} 

Explanations Th« RZH covaand Xata ymi dtiang* ta»% oawi of a £il« 
tbat is eatalogad in tha diractory ^f a disk. 

Tha naw-€ilaspao mat not ba tha nana of any azisting 
fila on tha disk. Tha oid-£ilaspae idantifias an 
axisting £ila on tha disk. 

Tha REST coKWind changaa tha nana of tha fila naaad by 
old-filaspac to tha naaa fivan as naw-£ilaspac. If 
you put a spaea batvraan tha old-filaspac and tha 
aqual sign or batiMan tha naw-£iXaspac and tha aqual 
sign* you snast: insart at laast ona spaca on tha 
os^poaita sida of tha aqual sign. 

Cf/M->8000 offara you a saeond atathod of using tha 9J0S 
ooMMnd. Typa BBS than pcaaa RSTUSH. BSBT praa«)ts 
^tha-'foUoifiitg display s,--- 

tntar Old nana «^.-^ 

'OMreuraer appaacs folloiwing Sn«axr Old HasMi. Bn tag 
tha filaspace you want to ranana and prasa SETUiOI. 
tha following Una appaars on your saraani 

Sntar Saw Siums_ 

tha ouraor than appaars following Bnta g Smm tfaaas. 
typa in tha naw-filaapao and praaa BSTUSa to axaouta 
tha RBI coniand. 

aaf doaa not aaka a copy of tha fila. RES changaa 
only tha naisa of tha fila. 

If you oait tha driva spacifiagf fUEET assuaaa tha fila 
to canaaa is on tha da fault driva. You can includa a 
dxiva apacifiar aa a part of tha naw nana. Xf both 
fila spacifications nana a driva, it auat ba tha saaa 
driva. 

If tha fila givan by tha old naaM doaa not axiat, R£3I 
displays tha following aasaaga on tha scraan: 

Ho Fila 
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I£ the file given by the new name is a.iready present 
in the directory, RS^ displays the following message 
on the screen : 

?ile Already £xi«t;s 

REN does not allow for wildcard filenames or 
filctypes. If you try to use a wildcard r REN tells 
you: 

No wildcard fileaaaes 

Examples: The following eoasoand renasMia the file MORTAL. LST to 

IMMORTAL. LST OQ drive A. 

A>RB7 Z»«3I»M..LST«MaRSA£..Liffr 

If you enter the following eooaandi 

A>RXI 

The systea prompts for the filespttcs: 

Cacer Old liaswtX.FBa' 

Enter Hew Haaer :T.F8V 

A> 

File X.PRN is renamed Y.PBIf on drive A. 

In the following example, the file Y.PLI changes to 
X.PAS on drive A. 

B>RJBai AsX.FA&-^.FX.Z 

In the next comaaxid, the file OLD LI ST changes to 
NEWLIST on drive B. Because the second drive 
specifier, B: is implied by the first one, it is 
unnecessary in this example. 

A>RSi BsHKWI^Sr-BsOLOUSr 

The comaaod line above has the same effect as t]he 
following: 

A>RBf BsHEMLIST-OLOLXSr 

or 

A>RE» HEirLIST-B:OLDLIST 
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STAI 



Syntax I 



STAT 

STAT £ile«peo {BOl BBTlSYSlDZRlSIZB] 

STAT (dslDSKs I USRt 

STAT VAL« I OEVt 



Sxplaiuttioni 



The various forme of the OTAT coanand give you 
inforaation about the diak drives, files, and devices 
associated with your coa^uter. STAT lets you change 
the attrihutes of files. You can also assign 
physical devices to the STAT logical device naaes. 

note that thm options folloifing filespec can appear 
in square brackets, C3, «r without deliaiters a« 
shown in the syntasE section above. 

The notation Of tells you that a file is in a S«kd- 
Write state so ^at data can be both read froa and 
written to the file. A file aarked R0« Read-Ooly* 

can be r*iud froM but not written to. 

QaliJse other CP/M products, you cannot use STAT ia 
CP/M*8000 to s«t a drive to a aead-Only state. 
Orives are in a llead-4ftite state by default and 
taeco Bwi Rifad'-QKily only when you reaove a disk cm tdiic^ 
a file is open. The drive reverts to a Asad-Mrite 
state whenever you exit a program or type a CTHlr-C, 
either of which causes a wars boot. See Section 4 
for a discttsiaioa of tarainating programs and the term 
"warm boot. * 

Sxcept for STAT VAX,) anl SFAT DEVt , the STAT commands 
allow you to use a drive specifier. In CP/M-dOOO, 
you can specify a drive that is different from the 
currently logged-in drive. The drive letter that 
appears in yemr system prompt identifies the logged- 
in drive. Execution of a STAT command with a drive 
specifier thiat differs from the logged-in drive does 
not change the logged-in drive. 

In a STAT command, when you specif a drive that is 
different from the logged-in drive, you place that 
drive in active status. Active status ia any drive 
accessed since the last warm or cold start. If you 
execute a STAT or STAT OSK: command without 
specifying a drive, STAT responds with information 
for any or all drivee on active status. 
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Pro« Space an Disk 



Syntax 



STAT I d : j 



Explaxiatioa: STAT with no comm&nd ta.ll reports the amount of frae 
storage space that is available on all on-line disks. 
This £ors of the STAT coimawnd reports free space for 
only those disks that have been accessed since CP/M- 
8000 was last started or reloaded. You con find the 
amount of free space on a particular disk by 
Including the drive specifier in the coauaand tail. 

Ttiis form of the STAT comsand displays information on 
your screen in the following for a: 

d: RW, Free Space: nnK 

where d is the drive specifier/ and n is the nuaber 
of kilobytes of storage reaaining on the disk in the 
drive specified by d. 

Exaaples: Suppose you have two disk drives containing active 

disks. Suppose also that drive A has 16K (16,384) 
bytes of free space, while drive B has 32K (32,768) 
bytes of free space. After you enter the STAT 
coBuaand, you see the following nassages display on 
your screen : 



h>SSKS 

At RW, Free Space: ISk 
B: BM, Free Space: 32k 



Suppose drive B has 98 kilobytes of storage that is 
free for program and data storage. Enter the STAT 
cotmand, specifying drive B; the following message is 
displayed on your screen: 



B: KW, Free Space: 98K 
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Filaa - Display Fll* Spaca and Accass Mods 

Syntax t STAT filaspais {SIZE} 

Satplanations this tors of tha STAT coaaand displays tha leilobytss 
of spaca usad by tha spacifiad fils. It also 
displays tha Accaaa Moda of tha fila. STAT acespts 
wildcarda in tha filanaaa axul filatypa part of ths 
coaaand tail. Misn you iacluda a wildcard in your 
fila spacification, tha STAT cooaand displays a Ust 
of quail fyinci filas* with thair fila charactsristics, 
£roa tha dafault or apacifisd driva. STAT also sorts 
this list alphahatically. 

Sbta that tha SIZE option following tha filsspac can 
ba snclosad in aquara brackats, 12, ba pcacsdad by a 
dollar sign* 9# or ba includad in tha cooDsand with no 
daliaitac^ as in tha pracsding syntax Una. 

>C9/M-d000 supports four fila Aecasa ttodas: 

no 'Tha fila has tha »aad-Only attributa that 
ai30wa data to coas froa tha filSf but tha fila 
oanaot ba altarad. 

^ tha fila haa tha Raad-^irita attributa that 

all^swa -data to aov« ^ithar to or from tha fila. 

SYS Tha fila has tha systaa attributa. Systaa 
filaa do not appaar in OIR (dirsctory) 
diaplaya. U»m oms to show systaa (SYS) filas. 
Umm tha STAT -cow^nd to display all filas 
iaeludiag thosa with tha systaa attributa. Tha 
STAS cinanand ahowa systaa filaa in paranthaaas- 

OXa Tha fila has tha dirsctory attributa and 
appaaza in DIB (diractory) displays. 

A fila haa sithar tha HO or HW attributa, .and eithar 
tha SYS or OIR attribute. By dafault, and unlsas 
changad by itha STAT coaaandr a fila has ths RW and 
OIR attributa s. 

This foraat for tha STAT coaaand producas a list of 
fila characteristics under five haadinga: 

a Tha first coluam displays tha nuabar of records 
usad by tha filSr v^ara each record is 128 bytes in 
Ittigth. This value is listed on your screen under 
tha colujm marked Racs. 
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• The second coluan displays the number of kilobytes 
used by the file, where each kilobyte contain* 
1,024 bytaa. This value ia listed under Bytes. 

• The third column displays the nuaiber of directory 
entries used by the file. This value appears under 
the FCBs coiuan. FCB (File Qantrol Block) is 
another nane for a directory entry. 

• The Access Modes are displayed under the Attributes 
coluan. 

• The file specification, consisting of the drive 
specifier, filenase, and tiletype of the file 
appears uixier U^sm on your screen. 

Dae the SIZE option to tell STAT to compute the 
virtual file size of each file. The virtual and real 
file size are identical for sequential files, but can 
differ for files written in randoa node. When you 
use SZZSt the additional colusn, aarked Size, is 
displayed on the screen. The value in this eolum, 
represents the nuaber of filled and unfilled records 
allotted to tiio file* 

vftioD you enter the coBstaod STAT *.*, STAT performs a 
directory verification to ensure that two files do 
not share the saiM* disk space allocation/ that i», 
the indicated file dies not share a portion of the 
disk with, another file in the directory. If STAT 
finds a duplicate space allocation it displays the 
following messaget 

Bad Directory on d: 

Space Allocation Conflict: 

User nn d:f ilenaaa. typ 

STAT prints the user number and the naoe of the file 
containing doubly allocated space. More than one 
file can be listed. The recomaended solution is to 
erase the listed files, and then type a CTRL-C. 

STAT does a complete directory verification whenever 
a wildcard character appears in the coaaaDd tail. 
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Examplds: 



Th« following coBoaand t«lla STAT to display the 
character ia tics o£ all filaa on drive B that begin 
with the letters MY, and have any filetype at all. 

A>ffDhir B«MX*.* 

Aseuae that <Sxive B contains three files that satisfy 
the file specification. The screen could display the 
following t 



Drive B« 

Keoa Bytes TCBs 

16 2K 1 

a IK I 

32 18K 2 



Attributes 
Dir BM 
Dir RO 
Sys RO 



User 

fiiaae 
BsMYPROG 
BtMYTSST 
BiMTTRAlI 



.8101 
.OAT 
•ZSR 



totals 23K 4 

B< lOf* Peee Space t 



(3 files, 
243K 



21 - IK blocks) 



Th« tt«xt coswand causes the saae action as the 
previous convuad, but includes the Siae coluan in the 
diaplay • 

Asstis* that MTTSST.Sda was ttritten using randoa 
access iSroa record nuaber d through 15, leaving the 
firs« a records eopty. The virtual file sise is 16 
records* although the file only oonsuaes eight 
records, the screen Appears as follow ss 



Drive 8t 

Sis* Ibioe Bytes fCle - Attribute* 

16 16. 2K 1 Sir »l 

16 a IK I Oir 80 

32 32 18K 2 Sys BO 



Qser 

iXaae 

BtMsrntoG 

BtirrcssT 

BiMrtRAH 



.anff 

.OAT 
.Z8K 



Total I 23K 

Bi BW, Fre« Space* 



4 (5 files, 
243K 



21 - IK blocks) 



Sbte that the figure for total bytes, 23 K, includes 
directory space as well as space used for files. 
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Set File Access Modas (Attxibutas) 

Syrji::ax: STAT fiiespec RO I RW I SYS I DIR 

Explanation: Tiiis form of the STAT coBunand lets you set the Access 
Mode for one or more files. Note that the option 
following fiiespec can be enclosed in square 
brackets, C]. be preceded by a dollar sign, $, or be 
includ«d with no delimiter as shown above. 

The four Access Modes, described above, are: 

RO 

DIR 

A file can have either the RO or RW Access Mode, but 
not both. Similarly, a file can have either the SYS 
or DIR Access Mode, but not both. 

Sx&Bples: This coauaaad sets the Access Mode for the file 

LETTER. TXT on the default drive to Read-Only. 

h>SCKT LEmnUTXT RO 

The following message appears on your scrsen if the 
file is present: 

LETTER. TXT set to RO 

The following command: 

B>SEAT Jw*.2aK STS 

sets the Access Mode for all files on drive A with 
file type Z8K to SYS. Given that the three command 
files PIP, ED, and STAT are present on drive A, the 
following sfessags appears on your screen: 

PIP.Z8K set to SYS 
ED.Z8K set to SYS 
STAT.28K set to SYS 
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Display Dl«k StaHua 



Syntax t 



STAT (d<}OSKs 



SzpXanatioas 



This fora o£ tha STAT oOMaand displays injtorastion 
coscaraing tlia intaraal eharactaristlcs of your disk 
stocaga systaa for all on-lina disk drivas placad in 
activa status. This fora of tha STAT eonaad is 
providad for advaaead prograoaing functions, and is 
not naeassary tor your avaryday usa of CP/M-aooo. 



Zacaaplast Ibis STAT coaaand displays inforaation about driva A 

and any othar drivas that bava baan placad in activa 

:StatUS8 

A>9BMT IMnC« 

STAT BuppUaa auabara for n in tha following foras 

As Oriva OuncaQtaristiea 
nanns 128 Byta Kaoord Capacity 
mums Kilobyta Oriva Gapaeity 
nanns 32 Byta Oiractoey Sntrias 
nanns Chaekad l}iraetory intrias 
nanns 128 Byta Ba^ords/Siraotory Sntry 
annns 128 Byta Saeords/ Block 
mmnt 138 Byta lEteeeards /Track 
nnnnt Baaarvad Tracks 

Tha following eoaaand producas tha typa of 
iaforaation «l»oim in tha pravious axaapla, hut for 
driva 8. 

A»flfliT BiOSKs 



Oiaplay llsar aaabars with Acrtiva Filas 



Syntax s 
Explanations 



STAT (dsIaSRs 



This fiora of tha STAT co) 
usar ausdsara that hava 
spacifiad driva. 



nd lata you datarmina tha 

filas on tha disk in tha 



Osar nu^ars axa assignad to filas that ^rm craatad 
undar CP/M-dOOO. Usa this fora of tha STAT coaaand 
to dataraina tha activa usar aun^ara on a diak. 
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Exaa^jles: This command displays the user numbers containing 

active files on the disk in drive A. 

A>STILr USR: 



Display STAT OonrnnnAm axid D»vice tlajeaa 

Syntiuc: STAT VAL: 

Explanation: STAT VAL: display* a suaoBary o£ the general forms of 
the STAT coaaoands. It also displays the possible 
physical device namas that you can assign to each of 
the four CP/M~8000 logical device aajnes. 

Sxanples: The STAT VRl.: display is ebo»ca b«low: 

A>STAT Vlilit 

Set Attribute: dsfile»a»e. typ Cro] Crw] Csys] Cdir] 

Disk Status : DSR: d;OSK.: 

User Status : USR: dtUSR: 
lobyte Assign: 



CON 
AXI 
AXO 
LST 
A> 



■ TTY: CRT: BAT: OCl: 

« TTY: PTR: DRl: UKl 

« TTY: FTP; DPI: UP2 

" TTY: CRT: LPT: ULl 



Display and S«t Phy»ical-to-Logica.i Device Assigtiswnts 

Syntax: STAT DEV: 

STAT logical device: - physical device: 

Sxplaaation: STAT DEV: displays the current aesignments for the 
four CP/M-8000 logical device aaaes: CON:, RDR: , 
PUN; , aiad LST: . Use the second form of the above 
STAT conxnand to change these current assignments. 
The command STAT VAL: displays the possible physical 
device nanes that you can assign to each logical 
device name. Refer to the part of the STAT VAL: 
display entitled, lobyte Assign, shovm above- 
When you assign a physical device to a logical 
device, STAT assigns a value from to 3 to the 
logical device name in what is called the lobyte. 
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You can assign any of the listed physical <i«vice 
naaea to tlieir appropriate logical device naaes. 
However, the assignment does not work unless you are 
using the proper Input/Output Port (I/O) on your 
computer, with the proper cable to tonnect the 
computer to the device, and the proper I/O driver 
routine for the particular physical device. This 
facility oust be supported by the manufacturer of 
your computer before the physical-to-iogical 
assignments can be meaningful. 

Sxaspless K>SnBMS CCHfs >■ CBTt 

This command assigns the physical device name CRT: to 
the logical input device name COHj , which generally 
refers to the-con»ole- ^ ^, 

k>St»IX 1*ST*- »:ia?iPi .'\„'; , 

The command above assigns the physical device name 
LPTi to the Ipgicml output device name LST:, which 
generally r«<ers to the list device or the printer. 
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SUBMIT Command 



SUBMIT 



Syntax : 

Explanation i 



( SUBMIT } { £ ilespec ( &r guaentl 



argument 9) ) 



That SUBMIT coanwand lets you execute a group or batch 
of comnands £roa a SUB file, which is a file with a 
file type of SUB. 

Usually, you enter coauitandB one line at a time. If 
you Bust enter the sajne sequence of coou&ands several 
tiaaes, you aight find it easier to batch the commands 
together using the SUBMIT command. To do this, you 
create a file and enter your coamands in this file. 
The file is identified by the filename, and must have 
a fiietypa of SUB. When you issue the SUBMIT 
mwmnnd. SUBMIT reads the file named by the filespec 
and prepares it for interpretation by CP/M-8000. 
When the preparation is complete, SUBMIT sends the 
file to CP/M-SOOO line by Ixne, as if you were typing 
each cosiaand. 



Elxample: The following saople lines illustrate some of the 

variet^y of commands that can be entered in a SUB 
filet 



;This is an exeusnle SUBMIT file comment. 

DIR 

DIR *.BAK 

ERA ♦.BAK 

PIP LST.— $1.PR»CT92 53 ?4 3 

DIRS *.zaK 

PIP A.-*.LTR 
DIR as 



Creatiztg thm SUB File 



Explanation: 



The SUB file can contain any valid CP/M-aOOO command 
or any valid CP/M-8000 command with SUBMIT 
parameters. You can even reference other SUB files 
in a SUB file. Embedded files of this Icind are 
treated as chained files, not nested files. That is, 
any conjoands following an embedded SUB file will be 
ignored? a SUB file called by another SUB file never 
returns to the caller after successful execution. 
For that reason, the last line in a SUB file is the 
only useful place for an embedded SUB file. 
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A semicolon is the delimiter used for a comment' in a 
SUBMIT file. The comment oust be entered on a line 
by itself and start in the first column of that line. 
Ooaaents print on the console exactly as they are in 
•the SUBHIT file. 

Ygu can put more than one command on a line if you 
separate eai^i coasuuid with an esEclamation mark. For 
exai^le* 

contains three distinct C7/M-8000 commands on one 
line of a SOi^iXT file. The length of the line must 
net exceed 128 characters. 

Yoa can create the SUB file with the SO utility, with 
some other editor* or with a word processing program. 

Toa can pasa arguments to SUB f ilee when you exeerute 
them. Each argument you enter is assigned to a 
parameter in the SOB file. The first argtiment 
teplaeee' every oeearrence of 91 in the file* the 
second argument replaeee parameter $2, etc., up to 
paraaetar $9. Hhm $0 parameter always substitutes 
for the StIBttIT fila itself. For exai^le* if ycnar 
tiXm .3?t^JKS*SUB coataiav the following coamandss 

EStA $1.BAK 

flia $1 

FIP Ai$l«A<$2.Z8K 

and y«Ki eater th«f callow in^ SUSMTI commands 

A>«rBMZT STMS S^ VOL 

SUBMIT substitutes these actual parameters for the 
symbolic stand-in parameters in your START. SCB file 
as sequential execution occurs. In this exaA^le« the 
argument SAM is substituted for every 91 in the 
START. SUB file as sequential execution occurs, TEX is 
substituted for every occurrence of $2 in the 
START. SUB file# and STAAT is siibstituted for $0. As 
each line is encountered in your SUB file, SUBMIT 
then executes this file, line by line. The 
substitutions look like this to SUBMIT: 

ERA SAM.BAK 
OIR SAM 

PIP AsSAM-AsTEX.ZSK 

PIP A: FINISH. SUB-START . SUB 

5-41 



CP/M-8000 User's Guide SUBKIT Command 

If you enter fewer arguments in the SUBMIT command 
than there are parameters in the SUB file, the extra 
parameters are not used. 

If you enter more arguments in the SUBMIT command 
than there are parameters in the SUB file, the extra 
arguBwnts are igxaored. 

To include an actual dollar sign, $, in your SUB 
file, type two dollar signs in a row, $5. SUBMIT 
replaces them with a single dollar sign. For 
example, i£ you have d file SEARCH. SUB and it 
contaizis the line: 

DIR $li».S$55$$ 

and you eoter the following SUBMIT comsiand, 

AXRJBHXT STCABCH B 

then the translated file contains the following: 

DIR Bt'.SS? 

The nart effect in this eraapla is that CP/M-8000 
looks for all files on drive B that have the file type 
of S$$. 



E^acutixkg tbe SOBHZT 

Syntax: To appreciate how SUBMIT is executed, recall the 

syntax mentioned earlier: 

{SUBMIT} {filespec (argument! ... argument9 } } 

Explanation: Based on the above syntax, there are five ways of 
executing a SUBMIT comanand before the parameter list 
is evaluated : 

SUBMIT filename. SUB 
SUBMIT filename 
filename .SUB 
filename 

SUBMIT 
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If thtt first form is used, CP/M~SOOO first looks in 
your current user number £or the filename you typed 
with the filatype of SUB. If that file specification 
is found there, SUBMIT tries to execute the file. If 
it is not found in your current a^er number. CP/M- 
dOOO then searches user for fileniuM.SUB. If it is 
net fou!^ in either user number, CP/M-3000 displays 
your filename followed hy a question mark on your 
console. 

12 the second form is uaed# C7/M-6000 appends the 908 
filetype to y<Mr filename and searches for that file 
specification in your current user number, then in 
user Of if ne«d be. If that file specification is 
found, SUBMIT tries to execute the file. If it is 
not found, CP/M-8000 displays your filename followed 
toy a question mark on your console. 

If the third form is used, CP/H-8000 assumes you want 
to izxvoke the SUBMIT command because ^au supplied the 
sua filetype. If that file specification is found in 
your current \iamx number (or user 0)« SUBMIT tries to 
execute the file. If it is not found, CP/M-8000 
displays your filename followed by a question sttrk on 
your console. 

If the fourth form is used, the general rules of file 
searching as set forth in Secl^ion 4 take precedence 
as shown in tiie following four steps < 

1. CP/M->dOOO assumes you are trying to invoke a 
program file in your current ammz number, but 
CP/H-8Q0Q does not assume you supplied a filetype* 
Therefore, CP/H->8000 first appends a filetype of 
ZBK to y^ar filename and searches your current 
user oumber for the file. If a file with your 
filename and a 28K filetype is found, CP/M-8000 
ezeeutea that file without invoking SUBMIT. 

2. If a file with a ZSK filetype is not found, CP/M- 
8000 substitutes a blank filetype £or the ZSK 
filetype it appended to your filename and searches 
for this file specification in your currant user 
number. If such a file exists, it is executed and 
SUBMIT is .again bypassed. 

3. If the file specification with the blank filetype 
is not found, CP/M-80G0 substitutes a SUB filetype 
for the blank filetype and searches for this £ile 
specification in your current user number. If 
filename. SUB is found, CP/M-dOOO recognizes that 
you want to execute a SUBMIT file: control passes 
to SUBMIT, and SUBMIT tries to execute your file. 
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4. If CP/M-8000 ia unable to find any of the above 
combinations in your current user number, it 
searches user first for your filename. Z8K, then 
for your f ilenaae. < blank > , and finally for your 
filename. SUB. If none of these three file 
specifications are found in either the current 
user number or user 0, CP/H~8000 displays the 
command keyword followed by a question mark. 

If the fifth form (SUBMIT) is used, CP/M-8000 prompts 
you for your file specification: 

Enter Filename: _ 

The underscore represents your cursor's position. 
You can then reply with a filename having a blank 
filetype or with a filename having a filetype of SUB. 
It you provide a blank filetyp«# CP/M-8000 appends 
the SUB filetype for you. If you provide any 
filetype other than SUB or blank, CP/M-8000 rejects 
it as inappropriate for SUBMIT and asks you to supply 
a filename with a filetype o£ SUB or blank. 

Example: Enter SUBMIT at the 8ya.teffl prompt: 
A>SDBKrT 

the system prompts: 

Enter Filename : 

Enter the filespec and arguments here, such as 

START a TZX 

Another example could be: 

A> SUBMIT BUBBik 

where you enter the filename, BUBBA, after the 
program name, SUBMIT, on the command line. 
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TYPE Command 



TTTEGoi 



SYntMxt 



TCVE itilmm^pmc} 



SxplanatioBs 



Tim TfFE built'-in coauBand displays tha contants of a 
charactar 211a on your ii«cra«n. I£ tha £ila occupies 
ooca than a tcraaaful ot space* TYPE scrolls tha file 
vertically vsp the screen. Presa CTRL^ to stop the 
scrolling and CTRIrK} to resume. Wildcards are not 
permitted with this cenaand. 

Tab characters occurring In the file named by the 
file specification are expanded to every eighth 
column position of your screen. 

To abort tha TYPE command while text is scrolling on 
your screen, preaa CTRL-C. 

Be sura that tha file specification you enter 
idantiflaa a file containing charactar data. 



Szamplaat Tha following coaaiand displays tha contents of the 

file MYFItoa.ASM on your screen. 

A>«sps MiPBoa.ikai 

Thm next cammysnd displays the contents of the file 
TBZS7IZ*S from drive 3 on your screen. 

Jl>fSFB BtTBXSWJUt 

TYPS can also be executed without a file 
specif ieatlOEt in tha command line. Whan you use TYPE 
in this aannar, you are prompted for ycxar file 
specif ieationx 

Enter Pilanaaas ^ 

Tha underscore represents your cursor's position. 
Aaapond with the file specification of the file whose 
contents you want to see displayed on your screen. 

If tha file namad by tha file specification is not 
preaant on an on-line disk, TYPE displays the 
following message on your screen: 

So Pile 
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To list the file at the printer as well as on the 
screen, type a CTRL-P before entering the TTPll 
command line. To stop echoing keyboard input at the 
printer/ type a second CTRI^P. 
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USER Coomand 



USER 



Syntax s 



USER (nuab«r} 



Explauiations 



QSSR is a built-in coaaand as«Kl to s«t th« currant 
UMur auBft)«r» Tha disk diractory can ba dividad into 
diatinct group a according to uaar nuatbars ranging 
from through 15 . 

n^ta CF/M-aOOO starts* ia tha currant uaar nuabar. 
Sxaeutabla Silaa craatad undar uaar ara accaaaibla 
froa any othar uaar aunbar. Filaa that you craata 
undar any uaar numbar othar than ara not accaaaibla 
undar any othar uaar nunbar, axci^t through tha PIP 
oonmand. Saa tha 6 option of tha PIP CoaoBand. 



Hxai^Xas Iha following eoaoand changaa tha currant uaar auaisar 

froa to 3. £lota that tha proapt changaa to 3A>. 

A>0SaR 3 

X3SBB. can also ba axacutad without apacifying tha uaar 
nuabar in tha coanand lina. I£ you do thia* USSR 
proapta yoii for your uaar naw au;ri»ar. 

K>t38MM. 

Entar Uaar ^s ^ 

Tha uadaraeora rapraaaata your cursor's poaition. 
Raapond with tha uaar nuabar you want to aaJca 
currant. 

Entar Uaar iSkaS 
SA> 

Tha currant uaar nuabar is now 5 on driva K. 



End of Saction 5 
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CP/lI-8000 Editor 



To do aJjBoat anything with a computar you a««d soma way to 
«ater data* soaa way to giva tha conputar tha information you 
want it to procaaa. Tha programa ooat commonly usad for this 
Uiak ara callad aditora. Thay tranafar your kaystrokaa at tha 
kayboard to a disk fila. CF/M-'dOOO's aditor is named CD. 
Uaing SO, you can craata and altar CF/M-aooo taxt filas. 

Tha corract conuoand syntax for invoking the CP/M-8000 aditor is 
givaa in "Starting SD.. " Aftar starting £D, you isaua commands 
that tranafar taxt from a disk fila to memory for editing. "ED 
Operation" details this operation and deacribea the basic taxt 
transfer commands that allow you to easily enter and exit the 
editor. 

''Baaie Editing Commands ** details the craamands that edit a file. 
"Combining SD Commanda" deacribea how to combine the basic 
commands to edit mora efficiently. Althcnigh you can edit any 
ciMuracter file with the baaic SD commands, SD provides several 
fflore commands that perform aore complicated editing fuzictiona, 
aa described in "Advanced SD Commands . " 

During an editing seaaion* SD can return two types of error 
messages. "SD Error Messages" lists these oessagea and 
providaa examplea that indicate how to recover from common 
editing error conditions. 



Syntax: ED fileapec filespec 

To atart ED, enter its name after the CP/M-aOOO prompt, 
followed by a file sipecif ication that contains no wildcard 
characters. The file specification, MYPILE.TEX in the 
following example, specifies a file to be edited or created. 
The file specification can be praeeded by a drive specifier but 
a drive specifier is unnecessary if the file to be edited is on 
your default drive. 

A>ED MY7ILS.TEX 
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Opt-ionaily, th« file specification can be followed by a drive 
specifier, as shown in the following exas^le. 

A>ED KYZTLE.TE3C B( 

In response to this coi&nand, ED opens tha file to be edited, 
MYFIIiE.TEX, on drive K, but sends all the edited naterial to a 
file on drive B. 

Optionally, you can send the edited aaterial to a file with a 
different fllenasM, as showa in the following exas^le. 

A>ED KXrni-TEC YOOKBTLE-WOC 

The file with the different filename cannot already exist or ED 
printis the following aessege and-' terminatftf;.' 

Output File Eififts, Erase It , 

The ED protupt, *, appears at the screen whea ED is ready to 
accept a conaoand, as shown below. 

A>ED KZ7ZUk«TBZ 



If no previous version of the file exists on the current disk, 
ED automatically creates a new file and displays the following 
message: 

N-EW FILE 

Botue: Before starting an editing session, use the STAT command 
to check the amount of free space on your disk. Make sure that 
the unused portion of your disk is at least as large as the 
file you are editing. It should be larger if. you plan to add 
characters to the file. When ED finds a disk or directory 
full, ED has only limited recovery mechanisms. These are 
explained in "ED Error Messages. " 



With ED, you change portions of a file that pass through a 
mennrary buffer. When you start ED with one of the commands 
ahovn above, this memory buffer is empty. At your command, ED 
reads segments of the source file, for example MYni*E.TEX, into 
the memory buffer for you to edit. If the file is new, you 
must insert text into the file before you can edit. During the 
edit, ED writes the edited text onto a temporary work file, 
MYFILE.$$$. 
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When you end the edit, ED writes the memory buffer consents to 
the teaporary file* followed by any remaining text in the 
source file. ED then changes the name of the source file from 
KXFIL2.TEX to MZ7IIi£.BAK« SO you can reclaim this original 
material from the backup file if necessary. BD then renames 
the temporary file* HZ7XLE.$$$, to M!;7ZLE.TE3C« the new edited 
file. The fioUowiag figure illustrates the relationship 
between the source file* the temporary work file and the new 
file. 

■otms ^en you ijnvoke ED with two filespecs, an input and 
output file, ED does not rename the input file to type .BAK; 
therefore, the input file can be Read-Only or on a write- 
protected disk if the output file is writtsn to another disk. 










Figure 6-1. Overall SD Operatioo 



In Figure 6-1, the memory buffer is logically between the 
source file and the temporary work file. ED supports several 
comazuls that transfer lines of text between the source file. 
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the memory buffer, and the tenporary (and erventuaily final) 
file. The following table lists the three basic text transfer 
coBaaeLnds that allow you to easily enter the editor, write text 
to the temporary file, and exit the editor. 



Table 6<-l. T«xt Traxuif«r CoKMiatis 



Coaannd 



Raault 



nA 



nW 



Append the next n unprocessed source lines 
froB the source file to the end of the memory 
buffer. 

Write the first n lines of the memory buffer 
to the taaiporary file free space. 

End the edit. Copy all buffered text to the 
temporary file, end copy all unprocessed 
source lines to the temporary file. Raname 
files. 



Apottodixag Tuct into tiMr Ba££ttr 

When you start EO and the memory buffer is eaqpty, you can use 
the A. (append). QoauBand t9 add text to the mausary buffer. 

aotsit SS caa i«uib#r lin«« of text to help you )ceap track of 
data in the ••Bory buffer. The colon that appears when you 
start ES Indicfttes that line numbering is turned on. Type -V 
after the ED prosit to turn the line number display off. Line 
numbers appear on the screen but never becoaiM a part of the 
output file. 

A ( Append ) Command . 

The A c omm a n d appends (copies) lines from an existing source 
file into the memory buffer ; it takes the form: 

nA 

where n is the number of unprocessed source lines to append 
into the memory buff sr . If a pound sign, #, is given in place 
of n, then the -integer 65535 is assumed. Because the memory 
buffer can contain most reasonably sized source files, it is 
often possible to issue the command tA. at the beginning of the 
edit to read the entire source file into memory. 

If a is 0, ED appends the unprocessed source lines into the 
memory buffer until the buffer is approximately half full. If 
you do not specify n, ED appends one line from the source file 
into the memory buffer . 
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SD Exit 

You can a«« the W (Wtite) cosmand or the S (Exit) coawand to 
«av« your editing changes. The W connand writes lines froa the 
aeaory buffer to the new file without ending the ED session. 
An S coaaand saves the contents of the buffer and any 
unproseesed saterial £roa the source file and exits ED. 

W (Write) Coaaand 

The W coaaand writes lines froa the buffer to the new filer its 
form isi 

nvr 

Where n is the nuaber of lines to be written firoa the beginning 
of the buffer to the «nd of the new file. If n is greater than 
0, BD writes n lines froa the beginning of the buffer to the 
end of the new file. If n is 0, ED writes lines until the 
buffer is half eapty^ The OW coaaand is a conv«i,ient way of 
alKing rooa in the aensry buffer for aore- lines froa the source 
file. Tou can deteraine the nuadser of lines to write out by 
eseoutiag a OV coaaand to check the aaount of fre* space in the 
buffer* as ahomx below t 

It •«¥ 
25000/30000 

The preceding display indicates that the total size of the 
BMHBory buffer is 30,000 bytes and there are 25,QOO free bytes 
in the aeaory buffer. 

Sttas After a W ctaaaand is executed, you oust snter the H 
caaaand to reedit the saved lines during the currant editing 

sassioa* 

E (gxit) Coaaand 

An E caaaand performs a noraal exit froa ED . The fora of the B 
coaaand is x 



follo%«ed by a carriage return. 



when you enter an S coaaacud, ED first writes all data lines 
froa the buffer and the original source file to the new fila. 
If a .BAK file exists, ED deletes it, than renanes the origixxal 
fila with the .BAK file type. Finally # ED ranaasa the new file 
froa filenaae.$$$ to the original filetype and returns control 
to the operating syaten. 
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The oper&t.ion of tha E coiouiDd loakeB it unwiae to edit a bauzlci^ 
file. Viien you edit a. BAK file and exit with an E conaand, ED 
erases your original file because it has a .BAK file type. To 
avoid this, always renans a backup file to aoae other filetype 
before editing it with ED. 

Bote: Any coaatand that tersinates an ED seas ion oust be the 
only costsand on the line. 

The text transfer commands discuaaed above allow you to eaaily 
enter and exit the editor. This section diacusa«8 the basic 
commands that edit a file. 

ED treats a file as a long chain of characters grouped together 
in lines. ED displays and edits chaxactara and liaas in 
relation to an iaaginazy device called the charactar pointer 
iOP). During an edit aeaaion, you suat ■entall.y picture the 
CP' 8 location in the memory bu££er and iaaue coxmanda to move 
the CP aod edit the file. 

The following coonanda move the charaetmr pointatc or diaplay 
text in the vicinity of the CP. These ED coMsaxKla conaist of a 
numeric argument and a single command letter and surst be 
followed by a carriage return. The numeric argument, n, 
deterainea the number of tiaaa I3> executes a command-; however, 
there are four apaeial eaaea to cocnaider la ragard to the 
numeric argument! 

• If the numeric argument ia osxttod, ZD aaaumea an argument of 

• Uae a negative nuisber if the command ia to executed backwards 
tixrough the memory buffer. (The B command ia an exception) . 

• If ycu enter a pound sign, t, in place of a number, ED uses 
the va.lue 65535 as the argument. A pound sign argiimest can 
be preceded by a minus sign (>#) to cauae the command to 
execute backwairdB through the memory buffer. 

• ED accepta aa a nuxMric arguaent only in certain commanda. 
In aome caaea, cauaea the command to be executed 
approximately half the poasibla numbetr of tiaea, nAiila in 
other cases it prevents the movement of the C?. 



The following table alphabetically sumaiarizes the baa ic editing 
commands and their valid arguments. 
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T^bl* 6-2. Basic Alitiiig CoaMuods 



COIDUIZXI 



AetlOQ 



a, -B M9v« CP to th« b«ginning (B) or md (-8) of 

tla« aoaory buffsr. 

nC, -nC Mav« CV n charactara forward (aC) or 

baclciMird (-aC) through tha aaaory buffar. 

aO, -nD Oaiata a charactara bafora (-nD) or aftar 

(nO) tha CP. 

I Batacr inaart soda. 

latringTZ Xnaart a atring of charactara. 

aK, -oK Oalata (kill) a Unaa bafora tha CP (-nK) 

or aftar tha CP (aK) . 

bL« "QL Nova tha CP a Uaaa forward (at) or 

hmciswBxd ( -oL) through tha aaaory buffar. 

aff, -nT typa a Uaaa ba^ra tha CP (-aT) or aftar 

tha CP io!S)i ' 

a» -o Hova tha CP a Uaaa bafcsa tha CP (-a) or 

aftarr tha CP (a) and diapiay tha 
daatination Uaa. 



Tha following sactiona diaouaa SD's baaic aditing conMada in 
aora datail. Tha axanplaa ia thaaa aactiona iUuatrata how tha 
cowaanda affact tha poaitioa of tha eharactar poiatar in tha 
aawsry buffar. La tar azaaplaa In "Coabining SO ConMnda" 
iUustrata horn tha eoBBanda ^ppoar at tha acraan. For thaaa 
aactiona, how«var# tha cireuaflax ayabol (') in coiaand 
axaaplaa rapraaaata tha eharactar pointar, *<iiich you mat 
ioagina In tha aaaory buffar. 

Monriag tha C3>azaetar Vointmr 

Thia aaetion daacribaa coamanda that aova tha eharactar pointar 
in ttaaful iacraaanta but do not diapiay tha daatination Una. 
Although 50 ia uaad priaarily to craata aad adit program sourca 
filaa, tha following sactiona praaant a siapla tazt aa an 
axaapla to oaka CO «aaiar to laam and ondarstaxid. 
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3 { aeginninq /Bottom) CoauBand 

The B cosunand moves the CP to the beginning or bottom of the 
memory buffer. The B command has two forms: 

a, -a 

-B moves the CF to the end or bottom of the memory buffer ; B 
moves the CP to the beginning of the buffer. 

C (Cheuraeter) Command 

The C command moves the CP forward or backward the specified 
number of characters; it takes the form: 

nC, ■•aC 

where n is the number of characters the CP is to be moved. A 
positive number moves the CP towi^rds the end of the Line and 
the bottom of the buffer* A negative number moves the CP 
towards the beginning of the line and the top of the buffer. 
You CBfi eater an n large aaough to move the CP to a different 
line. HcMpfever, each line i» separated from the next by two 
invisible ch&raetarst a c&rriage-retttm and a line feed 
representeid by *er><lf>. You mast co^Mwaaate for their 
presence. For example, if. the CP were positioned before the £ 
of Emily, the command 30C'i£)ves the CP to the next line: 

Emily IMckinsoo said/<cr><lf> 

"I fin*d ecstasy in living -<cr><lf> 

L (Line) Comffand 

The L command moves the CP the specified nuaber of lines. 
After an L command, the CP always points to the beginning of a 
line. The forms of the L enrnmand are: 

oL, -nL 

where n is the number of lines the CP is to be moved. A 
positive number moves the CP towards the end of the buffer. A 
negative number moves the CP back toward the beginning of the 
buffer. The cnwmand 2L moves the CF froa the first example 
line two lines forward through the mesKory buffer and positions 
the character pointer at the beginning of the line. 

Emily Dickinson said. <cr>';lf> 
"I find ecstasy in living -<cr><lf> 
"the mere aenae of living<cr >< If > 
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The cosmaxxa -L moves the CP to the beginning of the previous 
line, even if the CP originally points to a character in the 
i&iddle of the line. U^e the sp49cial character to aove the CP 
to the beginning of the current line. 

n (Nianber) Comaand 

The n coeoeand noves the CP and displays the destination line. 
The fioraa of the n enaaiand are 

a* ""tt 

where n la the number of lines the CP is to be aoved. In 
response to this comaand., SD aov^s the OP forward or backward 
the nuober of lines specified, then prints only the destination 
line. 

Saily Dickinson said, <cr>'< If > 
*"I find ecstasy in living -<Gr><lf> 

A further abbreviation of this cpaaand is to enter no nusdaer at 
all. In response to a carriage >»tu3n without a preceding 
coonani, E33 assuaea an n coaaand of 1 and tBOves the CP down to 
the next line and prints lt« 

:.,«»ily Oideinaon sftid, <cr»'<lf > .,■-,,,.■ 
**I find eestaey ia living «<cr><i^> 

Alsot a minus sign, •, without a nu^er aoves the CP back one 

line. 

Oisplayiag Meaory Buffer Cootents 

SD does not display the contents of the oemvy buffer until you 
specify which part of the text you want to see. The T comulikI 
displays text without woving the CP. 

T (Type) Coanand 

The T cosnand types a specified nunber of lines froa the CP to 
the screen. The T command takes the formes 

nT, -nT 
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where n specifies the number of lines to be displayed. If a 
negative number is entered, ED displays n lines before the CP. 
A positive number displays n lines after the CP. If no number 
is specified, ED types from the character pointer to the end of 
the line. The CP remains in its original position no siattar 
how many lines are typed. For example, if the character 
pointer is at the beginning of the memory buffer, and you 
instruct ED to type four lines (4T), four lines are displayed 
at the screen, but the CP stays at the beginning of line 1. 

"Emily Diclcinston said, <cr><lf > 
"I find ecstasy ia living -<cr><lf> 
the mere aenae of living 
is joy enough. " 

If the CP is between two characters in the middle of the line, 
a T command with no number specified typ»» only the characters 
between the CP and the end of the line, but the character 
painter stays in the same posit-itisn, «« shown In the memoiry 
buffer example below. 

"I find ee'stasy in living - 

Whenever ED is displaying text with the T ecawand, ycm can 
enter a CTRL-S to stop the di«pl«y, the«j a CTRI^-Q when you're 
re^idy to continue scrolling. Enter a CTRI/-C to abort long 
type-outs. 

Deleting Charactafs 

D (Delete) Command 

The D command deletes a specified number of characters and has 
the forma : 

rxD, -nD 

where n is the number of characters to be deleted. If no 
number is specified, tD deletes the character to the right of 
the CP. A positive number deletes multiple characters to the 
right of the CP, towards the bottom of the file. A negative 
number deletes characters to the left of the CP, towards the 
top of the file. If the character pointer is positioned 'in the 
memory buffer as shown below, 

Emily Dic>cin8on said, <cr><lf > 
"I find ecstasy in living -<cr><lf> 
the mere sense of living<cr ><if > 
IS joy "enough. " <cr>< If > 
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■■*. 
th« command 60 deletes the six characters after the CP, and the 
resulting Demry buffer looks like this: 

Emily Dlcdclason said, <cr><lf> 
"t find ecstasy in living — <cr><lf> 
the mere seas* of living <cr>< If > 
la joy *."<cr><lf> 

You can also use a D cosnand to delete the <cr><lf > b«t««en ti#o 
lines to join them together. Remember that the <cr> and <lf > 
are each counted as a charsicter. 

K (Kill) Command 

The K commazui kills or deletes whole lines from the memory 
buffer and takes the forms: 

where a is the nuodoer of lines to be deleted. h positive 
number kills lines after the CF. A, negative number kills linee 
before the CP. ^en no nuaber is specified, ZD kills the 
current line. If the character pointer is at the beginning of 
the second line (as shoim below), 

Ssily Dickinson said, <cr><lf > 
""1 find ecstasy in living «<cr><lf> 
the mere sense of living <cr>< If > 
is Joy MUDugh- '*<cr><lf > 

i^en the consand '-K deletes the previous line and the memory 
buffer changes: 

""•I find ecstasy in living — <cr><lf> 
the mere sense of .liviztg<ex><lf> 
is joy enough. " <cr> < If > 

If the CP is in the middle of a line, a K command kills only 
the characters from the CF to' the and of the line emd 
concatenates the characters before the CP v#ith the next line. 
K ~K command deletes all the characters betvMen the beginning 
of the previous line and the CP. A OR command deletes the 
characters on the line up to the CF. 

you can use the special i character to delete all the text from 
the CP to the begizxning or end of the buffer. Be careful when 
using #K because you cannot reclaim lines after they are 
removed from the oiemory buffer. 
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Basic 'Editing Conuaeunds 



LaBert.ing Characters into the Heaory Buffer 



Insert) Co nun and 



To insert characters into the nesory buffer from the screen, 
use the I cojunand. Its forms are: 



latring'Z 

When you type the first command , £1D enters insert aode. In 
this mode, all keystrokes are added directly to the memory 
buffer. SD enters characters in Imea and does not start a new 
line until you press the ENTER key. 



A>£D BsQDOTE.'nDC 



NEW FII*E 
•i 



Emily Oldciasoa said* 
*I find ecstasy in livingr 
tJbe mmtti mmxtBm at livlngt 
is joy aaough. " 



■ots: To exit from insert aod«, you mu«t press CTRLr-2 or CSC. 
When the EC prosit, *, appears on the screen, ED is not m 
insert oode . 

In command mode, you c&n use CP/M-0000 line-editing control 
characters to edit your input. The table below lists these' 
control characters. 



Ta2»le 


6-3, CP/H-«000 Liae-«aitiag controls 


Command 


Result 


CTRL-C 


Abort the editor and return to the CP/M- 
3000 system. 


CTitI/-E 


Return carriage for long lines without 


CTRL-e 


Delete the last character; typed on the 
currant line. 


CTRI/-U 


Delete the entire line currently being 
typed. 
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Tiabl* 6-3. (contantMd) 


••«v 




Aasult 


CTSL-X 
Rubout 


0«l«t« t;h« entire Xine 
typed. StLwrn a,a CTRIXJ. 

Bfinove the last character 
dharacter at the screen. 


currently bein^ 
•Ad echo deleted 



Motes In insert aode, the aaae line-editing eontrola exist 
except fior CTRL-^ and CTRL-S. 

Mien entering a coobination of nuabers and letters^ ycHi might 
find it inconvenient to preea the CAPS-LOCK key if your 
terminal translates caps-locked nuatoers to apmexaJ. characters. 
80 provides two ways to translate your alphabetic input to 
uppercase without affecting nuabers. The first is to enter the 
insert ctaBsand letter in uppercase s I. All alphabetlcs 
entered during ths course of the capitalized coauand, either in 
insert node or as <a string, are translated to uppercase. (If 
you enter the insert ooaaand letter in lowercase, all 
alphabetlcs are iaaerted as typed). The second aethod is to 
enter a a coBsand before inserting text. Uppercase translation 
reanins in ef f eot until you eater a *0 cosaand. 

Istring'^Z (Insert SferihQ) Coaaand 

The seecnd fora of the I eoaaaad does not enter insert node. 
It inserts the character string into the aeaory buffer and 
retmms iamediately to the ED proapt. You can uim CF/M-dOOO's 
line editing control characters to edit the coaaanil string. 

To insert a string* first usa ona of the ceaaands that position 
the CP. Yott aust aove tha CP to the place where you want to 
insert a string, foz exaa^le* if you want to insert a string 
at the beginning of the first linSf use a a coaaand to aove the 
CP to the beginning of the buffer. With the O? positioned 
correctly, eater an insert string, as shown below t 

iln 1870, *Z 

This inserts the phrase "In 1870, ** at the beginning of the 
first line, and retuams ijmnediately to the SD proapt. In the 
aeaory buffer, the CP appears after the inserted string, as 
shown below: 

In 1370, "Eaily Oiideinson said, <cr>'(lf> 
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fiepiaciog Characters 

S Substitute) Command 

The S command searches the memory buffer £or the specified 

string, and when the string is found, the S command 
automatically substitutes a new string for the search string. 
The S command takes the form: 

nSseareh string'Znaw string 

where n is the number of substitutions to make. If no number 
is specified/ ED searches for the next occurrence of the search 
string-^ in the memory buffer. For exaj^le, the command : 

llfflily Oic)clnsoo''ZThe poet 

searches for the first occurrence of "Ejaily Dickinson" and 
substitutes "The poet." In the aeaory buffar, the CP appears 
after the substituted phrase, as shown below: 

The poist" said, <cr><lf > 

If uppercase translation is enabled by a capital S command 
letticr, ED looks fbt a capitalized search string and inserts a 
capitalised insert string. Mots that .if you combine this 
cmnmand with other command s< you must terminate the new string 
with a CTRLi-Z. 

Omwrnhimimig EH Cmwmmmmdm 

It saves keystrokes and editing time to combine the editing and 
display commands . You can type any number of ED commands on 
the same line. SD executes the command string only after you 
press the carriage-return key. Use CP/M-8000's line-editing 
controls to manipulate ED command strings. 

When you combine several commands on a line, ED executes thorn 
in the order they are entered, from left to right on the 
command line. There are four restrictions to combining SD 
commands : 

• The combined-^onmand line must not exceed CP/M-8000 ' s 128- 
character maximum. 

• If the combined -command line contains a character string, the 
line must not ejirceed 100 characters. 

• Commimds to terminate an editing session must not appear in a 
combined-<:omj&and line. 
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• Coomands, such as tha I, J, R, S, axid X comnands, "^ that 
require character strings or filespeca sust be either the 
last coamand on a line or anist be teralnated with a cntL-Z 
or 2SC character^ even if no character itriag or filespec is 
given. 

While the exanplea in the prev ioue section shew the aeaory 
buffer and the poaiticn of the character pointer, the exanples 
in thie section show hoM the screen looks during an editing 
session. Reaeadser that the character pointer is ioaginary, but 
you oust picture its location because SD's cosBsands display ajod 
edit text in relation to the character pointer. 

Moving t3m cammntmr 9ointwr 

To sove the CP to the end of a line without calculating the 
ouaber of characters* cosbine an h coaoaand with a C cosBoand, L- 
3C. This coanand string accounts for the <cr><lf > sequence at 
the end of the line. 

Change the C cosnand in this coimaad Icrihg to sove the CF iwsre 
characters to the left. 1^ii can ^^»m iSXtis cosaand string if you 
oust sake a change at the «ld of th« line and you do not want 
to calculate the aual»e« of dha«aoters before the change, as in 
the following exaaple. 

li *t 

li asily Dickinson said, 

1* •t-7CT 

said, 

li ♦ 

in sp liSytiwy 



A T cDBasmd types from the CF to the end of th* line. To see 
the entire line, you can ccKsbine an L cooasand and a T cosoDand. 
Type our to oove the CP froa the aiddle to the begizming of the 
line and then display the entire line. In the example below, 
the CP is in the niddle of the line. OL soves the CF to the 
beginning of the line. T types firoa the CP to the and of the 
line, allowing you to see the entire line, 

3: *T 
sense of living 
3s **tJi;r 

3: the sMre amnmm of living 
3« * 



The ccnnand OTT displays the entire line without moving the CP. 
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Combining ED Command a 



To verify that an ED commana moves the CP correctly, combine 
the command with the T command to display 'the line. The 
following example combines a C command and a T command. 



2: •acr 

acst&oy in living - 
2: • 



Elaily OickinBon said, 
•I find ecstasy in living - 
the mere sense of living 
is joy enough. " 



Sdlt.ixa9 



To edit text and verify corrections quickly, cosibine the edit 
coaseaads with other SS comoaxids that move the CP and diapLay 
text. Coanand strings liXe the one below move the CP, delete 
specified characters^ and verify changes quickly. 

1: *15C5D<IW 

1: E;aily Dickinson, 

1: * 

Combine the edit command K with other ED coaa&ands to delete 
entire lines and verify the correction quickly, as shown below. 



£aily Dickinson said, 

"I find ecstasy m living 



The abbreviated foria of the I (insert) cosmand makes simple 
textual changes. To stake and verify these changes, combine the 
I comoaand string with the C command and the OLT command string 
as shown below. Remember that the insert string must be 
terminated by a CTRlr-Z. 



■"2001 to a friend^ZOLT 

Smily Dickinson said to a friend. 
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AmIvwblcc^ £B ComuuumIs 

Th* basic editing coamands discussed above allow you to use SD 
for all your editing. The following EO cousands, however, 
enhance SO's usefulness, 

Monrlag thm CP and Olsplanring Text 

P (Page) Coamand 

Although you can display any aaiount of text at the screen with 
a T connand* it is aoaetimes oiore convenient to page through 
the buffer, viewing whole screens of data and aoving the CF to 
the top of each new screen at the sane time. To do this, use 
5D's P coausand. The P coaaand takes the following forms: 

^ere n is the nunber of pages to be displayed. If ytm do not 
specify n* SO types the 23 lines following the CP and then 
aoves the CP forward 23 lines. This lea.vea the CP pointing to 
the first character on the screen. 

To display the current page withcnxt aoving the CP, enter OP. 
The special character prevents the ooveaent of the CP. If 
yt» speci'fy a negative nuaber for n« P pages bacicwards totmrds 
the top of the file. 

at (Line Muaber) Coaiaand 

VftMn line nuaber a are being displayed* SO accepts a line nuaber 
as a eoBnwnd to specify a destination for the CP. The fora for 
the line nuaber coaaand is 

ns 

where n is the nuabier of the destination line. This coaaand 
places the CP at the begizming of the specified line. For 
•xaaple* the coaaand 4i ousvea the CP to the beginning of the 
fourth line. 

Reaeaber that SD dynaaically renuabers text lines in the buffer 
each tiae a line is added or deleted*. Therefore, the nuaber of 
the destination line you have in aind can change during 
editing. 
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: n (Through Line Number) Commnnd 

T^e ixxvcrse of the line number command specifies that a command 
should be executed through a certain line number . You ctm use 
this command only with three £D commjtnds; the T (type) 
command, the L (line) command, and the K (kill) command. The 
:n command takes the following form: 

tacogrmand 

where n is the line number through which the command is to be 
executed. The :n part o£ th4 command does not move the CP, but 
the coBtmand that follows it might. 

You can combine n: with :n to sp«cify a range of linos through 
which a command shtiuld be executed. For exas^le, the command 
2::4T typma the second, third, and fourth lines, as shown 
balow. 



1; •2s:4T 

2: "l find ecstasy ia living - 

3: the mere sense of living 

4: is joy enough..* 

2: * 

Txiadisng «fid Beqplaistzig Chmrmexms Sturlng* 

ED supports a £lad coamand, T, that s«arches through the memoey 
buffer and places the CF after the word or phraee you want. 
The H ccanand allows EJD to search through the entixe source 
file instead of just the buffer. The J command searches for 
and th«n juxtaposes eharactier strings. 

F ( Find ) Command 



Ihe F command performs the simplest find function. Its form is 

oFstring 

where n is the occurrence of the string to be found. Any 
number you enter must be positive because ED can only s«arch 
from the CP to the bottom of the buffer. If you enter no 
number, £D finds the ntsxt occurrence of the string in the file. 
In the following exanple, the second occurrence of the word 
"living" is fouzui. 

i : *2f living 

3: • 

Ihe character pointer moves to the beginning of the third line 
where the second occurrence of the word "living" is located. 
To display the line, combine the find command with a type 
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conaand. Note that i£ you follow an F conuaand with another ED 
tryfiimin^ on the sane line* you oust terainate the string with a 
CTRL-Z* as shoim below. 

1, *2tl±w±i^*ZQXt 

.It the aere eense ot living 

It aakee a difference whether you enter the F coaaand in upper- 
^r lowercase. If you enter ?* SD internally translates the 
arguMHnt string to vqppercase. If you specify f« ZD looks for 
an exact aatch. For exaaple* FCp/a-aooo searches for CP/M- 
aOOO, but f^/a-dOOO searches for Q>/a<-8000 and cannot find 
CP/M-«000, or q?/a-aOOO. 

If ID does not find a natch for the string in the aeoory 
buffer* it issues the messages 

♦ 
BREAK "f KS 

whara tha syabol'f ladicatas that the search i^iled during the 
exeeutiion of an F coaaand. 

y Ooaaiwmi ^ ' ^ ' 

The g co^iinil extands the search fuaetioa beyond the aeaory 
buffer to laeluda the source file. If the search is 
sueoasaful« it laaves the C9 pointing to the first character 
after tha search string. The fora of tha fif coaaand Is 

niXfttring 

whera a is tha occurrence of the string to be found. If no 
nuabar is entered* SD looks for the next occurrence of the 
string la the file. Using an uppercase S in an S eooEBand has 
the saaa effect aa an uppercasa F in aa F coiaand. Glote that 
if you follow aa If coaaand vith another SD coaosand* yrai aust 
<»sraiAata tha string with a CXftL-3S. 

tlheB aa S coaaand is executed* SD searches the aeaory buffer 
for tha specified string. If SD doee not find the string, it 
doee not issue an error aessage. Instead, SD autoaatically 
writes the searched data froa the buffer into the new file. 
Then SO perforaa a OA coaaand to fill the buffer with 
onsaarched data froa the source file. SO continues to search 
the buffer* write out data* and app«id new data until it either 
finds the string or reaches the end of the source file. If SD 
reaches the end of thie source file* SD issuee the following 
aessage 1 

BREAK ***** AT 
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Because ED writes the searched data to the new file before 
looking for more data in the source file, ED usually writes the 
contents of the buffer to the new file before finding the end 
of the source file and issuing the error message. 

Bote; You must use the H command to continue an edit session 
after the source file is exhausted and the mamory buffer is 
emptied. 

J (Juxtapose) Conmand 

The J command inserts a string after the search string, then 
deletes any characters between the end of the inserted string 
to the beginning of the third (delete-to) string. This 
juxtaposes the string between the search and delete-to strings 
with the ineert string- The form of the J coBaand is 

nJsearch string* Zinsert striag'Z delete-to string 

where n i« the occurrence of the search strung. If no number 
is specified, ED searches for the next occurrence of the search 
string in the memory buffer. In the following exaa5>le, ED 
searches for the word "Dickinson" and inserts the phrase "told 
a friend" after it and then deletes everything up to the cofflma. 

It •♦T 

1: Emily Dickinson said, 

2: "I find ecstasy in living - 

3: the mere sense of living 

4{. is joy enough." 

1: *j Dickinson*! told a friend^X, 

1: 'Olt 

1: Emily Dickinson told a friend. 

i: • 

If you contJine this command with ot her commands, you must 
terminate the delete-to string with a CTRL-Z or ESC. (This is 
shown in the following example). If an uppercase J command 
latter is specified, ED looks for uppercase search and delete- 
to strings and inserts an uppercase insert string. 

The J command is especially useful when revising comnents in 
assembly language source coder as shown below. 

236: SORT. LSCI H , SW " ; ADDRESS TOGGLE SWITCH 

236: *j;*2aJ3DRESS SWITCH TOGC5L2*Z*I.*XOr.T 

236: SORT LXI H, SW ; ADDRESS SWTTCH TOGGLE 

236: • 
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In this ttX2uapie» £D searches tot the first ammiaoLdh and 
izuMurts ADDRESS SIi^TCH TOGGUB after the mark and then delates 
to the <cr ><].£> sequence* represented by CTRI«-L. (In any 
aaaceh string, you can aoe CTSLL-L to represent a <er><If> when 
yoar desired phrase extends across a Xine break. You cmn also 
xmm a CTB£r-I in a search string to represent a tab) . 

■eifcsi* If long strings sake your cosuaand longer than ywir 
saraen line length, enter a CTItLr-S to cause a physical carriage 
return at the screen. K CTKI(-'S returns the cursor to the left 
edge of the screen, but does not send the eoaatand line to ED. 
Ssaaeeber that no £0 conaand line containing strings can exceed 
100 ehamcters. When ]|^3U finish your coanand, press the 
carriag»-retiim key to send the coousiand to ED. 

M (Macro) Comand 

Aa 2D macro coousand, H, can Increase the useftilneas of a string 
of coaauuxds. The M cooxBand allows y<»a to group ED conaands 
together for repeated execution* The fora of the M cinsaand is 

nNcosoumd string 

^Amem n is th« .minb'Sr ' of tiaaa the ccmamnA atring is to be 
eiuweuted. A nfgativa nuaber is not a valid arguaent for an M 
' ^caaaand-. If oo''naj|iber is :.j[^)eteifie<l« the -special dciaracter # is 
aaeuaed, and SD fxeeutes' the coaaand string until it reaches 
the> and of da t|^ In thii buffer or the and of the source file. 
4Mpmad±ng on th« coaaanda specified in the string. In the 
folloifing exaaqple, |SQ executes the four c^Baands repetitively 
until it reaches thiii end of thm aeaory buffer t 

U «MEUvlag*Z«6<iii;iviag*201t 
3s "X find ecstasy in Living - 

3« that aere s«nse of hivtoig 

BREAK •#• AX "Z 

The terminator for an M coaaand is a carriage return; 
therefor a, an M coaaand aiuat be the last coaaand on the line. 
Also, all character strings that appear in a aacro oust be 
terainated by CTIIL*Z or SSC, If a character string ends the 
coabined'-coaaand string, it aust be terainated by CTRL'Z, thmn 
followed by a <cr> to end the M coaaand. 
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The execution of a macro command always ends in a BREAK "t" 
message, even wfhen you have limited the number of times the 
macro is to be performed, and EO does not reach the end of the 
buffer or source file. Usually the command letter displayed in 
the message is one of the coaaands from the string, not K. 

To 2Lbort a macro comaajod, press CTRL-^ at the keyboard. 

Movi£^ Text BlocdES 

To move a group of lines from one area of your data to another, 
use an X command to write the text block into a temporary LIB 
file, then a K command to remove these lines from their 
original location^ and finally an R command to read the block 
into its new location. 

X (Transfer) Command 

The X command takes the forms: 

aX 

nX f ile«pec''Z . 

where n is the number of lines from the CP towards the bottom 
of the buffer that are to be transferred to a ta^>orary file; 
therefortt, n must always be a positive number. If nd filename 
is specified, X$$$i??9$ is assumed. If no filetype is 
specified, LIB is assumed. If the X command is not the last 
command an the line, the coamnnd must be terminated by a CTRIr-Z 
or ESC. In the following example, just one line is transferred 
to the teaq»orary files 



•X 

*t 

Smily Dickinson said, 
nrt 
"I find ecstasy in living - 



If no library file is specified, ED looks for a file nju&ed 
X$9$$$$$.LIB. If the file does not exist, ED creates it. If. a. 
previous X coaunand already created the library file, ED appends 
the specified lines to the end of the existing file. 

Use the special character as the n argxament in an X command 

to delete any file from within ED. 
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•■*, 
R (Read) Commnnd 

The X cosmazxi tranatexa the next n lines from the current line 
to a library file. The R cosmand can t^txieve the transferred 
lines. The R cosnand takes the formsii 

R 

Rfilespec 

If no filenaM is specified, X$$$$$$$ is assuaed. If no 
filetype is specified* LIB is assumed. R inserts the library 
file in front of the CE*7 therefore, after the file is added to 
the fflemory buffer, the CP points to the same character it did 
before the read, although the character is on a new line 
number. If you coB±>ine an R command with other commands, you 
BBist separate the filename from subsequent command letters with 
a CTRIr-Z, as in the following example. Here ED types the 
entire file to verify the read. 

U *4l 

1: "I find ecstasy i^n living • 

2 I the mere sense of living 

3 1 i» joy enough. "• 

4t Smily Dickinson said* 

1: ♦ 

Sanring ox Abandoning Chmxngmmt SD Exit: 

you can save or abandon editix^ changes with the following 
three commands. 

H (Bead of File) Command 

An H command saves the coatants of the nemosy buffer without 
ending the ED session* but it returns to the "n^ead" of the 
file. It saves the enirrent changes azsd lets you reedit the 
file without exiting ED. The form of the H command is 



followed by a carriage return. 
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To execute an H command, ED first: finalizes the new file, 
transferring all lines remaining in the buffer and the source 
file to the new file. Then ED closes the new file, erases any 
BAK file that has the same file specification as the original 
source file, and renaaas the original source file filename. BAX. 
ED then renames the new file, which has had the filetype 55$, 
with the original file 'specification. Finally, ED opens the 
newly renamed file as the new source file for a new edit, and 
opens a new $55 file. When ED returns the * prompt, the CP is 
at the beginning of an empty xnemory buffer. 

If you want to send the edited material to a file other than 
the original file, use the following command: 

A>EZ) £ilesp«c dif£«raDti£iltt«p«c 

If you then restart the edit with the K command, ED renames the 
file differentfilename. $?$ to dif f erentfi lename.BAJC and creates 
a new file of dif f erentfilespec when you finish editing. 

; Oriainal) Command 



An O command abandons changes made since the beginning of the 
edit and allows you to return to the original source file and 
begin resditing without ending the ED session. The form of the 
conB&nd is 



folloitf«d by a carriage return. When you enter an command< ED 
confirms that you want to abandon your changes by asking: 

(Y/N)7 

You must respond with either a Y or an Nr if you press amy 

other key, ED repeats the question. When you enter Y, ED 
erases the tenroorary file and the contents of the memory 
buffer. When the * prompt returns, the character pointer is 
pointing to the beginning of an empty memory buffer, just as it 
is when you start £23. 

Q ' Ou i t ) Conummd 

A Q command abeindons changes made since the beginning of the ED 
session and exits ED. The form of the Q command is 

Q 

followed by a carriage return. 
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Wh«n you en tar a Q command « ED verifilea that you want to 
abandon tha changes by asking: 

Q (Y/S)7 

You muat respond with either a Y or an Nr if you press any 
other key, SO repeats the question. VSien you enter Y« ED 
^zmses the tesporary filer closes the source tiXm, and returns 
control to CP/MHdOOO. 

Sbtais You can enter a CS91i-C to iamediately return control to 
CF/M-dOOO. This does not give ED a chance to close the source 
or new files, but it prevents ED from deleting any temporary 
files. 



EC retuams one of two types of error messages: an SD error 
iMssage if SS cannot execute an edit ctnemand, or a CP/M-dOOO 

error aMssage if ED cannot read or write to the specified file. 

The form of an 8D eaezor message is 



nusAK 



AT c 



where x is one of t^e syi^ols defined in the following table 
and c is the cosBand letter where the error oeeurxed. 



IMbJEji C<-4* ID ficror Symbols 



Syidsol 



Meaning 



f Search failure. SD cannot find the string 

speQlfiefi la an f« S« <ttr If cosaaad. 

?c Uarecognixed ctnmaand letter c. SD does not 

reeognixa the indicated command letter, or an E« 
a# Q» or O command is not aixsne on its command 
line. 

So LIB file. SO did not find the LIB file 

specified in an R command. 

> Suffer full. ED cannot put any more characters 

in the owmory buffer, or string specified in an 
F, M, or S command is too long. 

S Command aborted. A keystroke at the keyboard 

aborted command execution. 

F File error. Followed by either DISK FUIL or 

DIRBCTOror FOIL, 
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rne following exanples show how to recover from conuaon editing 
srror conditions. For exanple, 

3REAK ">" AT A 

laeana that £D filled the ae&ory buffer before completing the 
tsxecution of an A eomnand. When this occurs, the character 
i^omter is at the end ot the buffer and no editing is possible. 
Use the CTW coaunand to write out half the buffer or use an or 
II eoHimand ajid reedit the file. 

BREAK "»" AT F 

means that ED reached the end of the nemory buffer without 
matching the string in an F command. At this point, the 
character pointer is at the end of the buffer. Move the CF 
1.^1 th a B or r: line number command to resume editing. 

If you get the following error message, 

BREAK "F- AT P 
.CI3K FULL 

uae the OX command to erase an unnecessary file on the disk or 
a 3#Xd:buf fer. sav command to write the contents of the memory 
buffer onto another dxs)c. 



EREAK "F" AT n 

DIRECTORY FULL 

use the same commands described in the previous message to 

r«cover from this file error. 

The following table defines the disk: file error messages SD 
raturns when it cannot read or write a file. 
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Tabla 6-S. BD Disk Fil« Brzor Ma«s«g«a 



Mvaniag 



aOOS tBR ON 4s RO 



Olak dt baa R«ad«*<tely «tt:ributa. This 
oecura it a diffarant disk has baan 
itUMTtad in tha driva sinea tha laat coZd 
OK warm boot. 



•♦ FILE IS REAJD OSLX •* 



TJia fila spacifiad in tha coBuoand to 
iavoka SD has tha RO attribute. SD can 
raad tha fila ao that you can axaaina it, 
but SD cannot changa a Raad-Cktly £ila. 



Sad o£ Saetlon 6 
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Eirror Messages 



Error ■••Mi<gr*« c(^i from a«v*ral ditimzmtit sourc««. Each 
utility supplittd with CP/lt-dOOO has its <Mm sat of «rror 
■■•sagas. Thsss asssagss ars diaplayad whtm thara ara arrors 
in tha utility conui,nd liaas* CP/M-dOOO also displays arror 
aassagaa whan thara ara arrors in calls to its huilt-in systaa 
aodulaa: tha Basic Disk Oparating Systaa (BOOS), tha Basic 
Input/Output Systaa (BIOS), and tha Consols Conmand Procassor 
(CCP). Tha BOOS providas functions that accass tha fila 
systaa* tha BIOS providaa functions that Intarfaca tha 
paripharal davica drivars for I/O procassing, and tha CCP 
providas tha usar intarfaca that paraaa tha usar cooaaz^ lina. 

Tha utility arror laaaaagaa and tha CP/M-SOOO aystaa arror 
aaaaagaa ara lis tad la Tabla hfl in alphabatic ordar with 
axplanations and suggaatad uaar raaponsas. Tha utility or 
systaa aodula that raturxi* tha arror aaaaaga is indicatad in 
tha axplanation. If you ara running an application prograa, you 
sight saa aassagaa othar than thoaa lis tad hara. Cback tha 
application program's df>m— ntation for azplanationa of thoaa 
nasaagaa* 

Iktola A-l. CF/lfr»dOOO InroE Maasagaa 



Massaga Haaning 



BAD DIRSC10H7 OH 0< 
SPACS AX4:.0CATI0H COMTLICT 



STXt arror * Tliis aassaga is followad hy a 
list, of onar or aora filanaswa. Tha filas 
lis tad hava baan doubly allocatad and 
contain data blocks that ara alraady 
allocatad to anothar fila on tha disk. 
Tha arror can ba cauaad by sithar a 
hardwara or aoftwara failura. 
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Tatila &,— I. (cGoitinued) 



Heasag« 



Maianing 



If ycu have B&iiita.in€Ki a backup disk with 
copies of your files, erase the &f£ected 
files and reboot CP/M-aooO. Rebooting the 
system cleans up the directory by 
reconstructing the directory allocation 
vectors. If you do not reboot the systea 
the error recurs. To replace the files 
you erased, COPY or PIP the files from 
your backup disk. If you do not have a 
backup disk, you must recreate the doubly 
allocated files. If you can tell by 
careful checking which portions of the 
files are duplicated or deleted, you can 
recopy or PIP the files froa the doubly 
allocated disk onto a new disk. Uee £S to 
recreate the deleted portions azui to 
delete the parts that d^re added to the 
vrrong files. To clean up the doubly 
allocated disk so that it can be used 
ag«.in, erase it coupletely (ERA *.*) and 
reboot CP/M-8000 . 

The problea that caused this enror sight 
or aight not recur. If you were running 
an undebugged program at the tisM the 
error occurred, check the prograa 
carefully for an error that aight have 
caused the space allocation error. If you 
were running a prograa that has be«n 
debugged and has caused no problea before, 
check your hardware- The error aight have 
b*en caused by a daiaaged drive or loose 
connection. If the problea persists, 
contact your technical support periwannel 
or the place you purchased your system for 
further assistance. 



Bad relocation inforaation bits 



CCP error. The aessage indicates that the 
file specified in the conmiand line is not 
a valid executable comnand file, or that 
the file has been corrupted. 
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Xabltt JW-1. (continttad) 



M»««8g« 



Mftaning 



Snaura that th« fll« ia a caantad fiX«. 
Section 4 of this oanual dascribca th« 
taramt. of a coanand fila. If tha fiXa has 
b««n cocruptad* raaaaaobla or racoiqplla 
th« tourea £lXa« and taXink it bafora you 
raantar tha coBaand llnm. 



BIOS SBRQR 



DISK 3C mr SOPPORTSD 

BIOS asxor. Tha disk driva indicatad by 
tha vmrijUsla X is not suppornad by tha 
BIOS. Tha BDOS lupporta a oaxiaua of 16 
drivast lattarad A through P. CSiack tha 
docmaantation providad by tha aanufacturar 
for youz systaa conflguratioa to fizid out 
Kfhioh of tha BOOS drivaa your BIOS 
iapXaaamta. Spaeify tha corraet driva 
soda and ra«atar tha coaaaad lina. 



BIOS latBiOB, '— Invalid Olsk 3tftt»s 



BIOS arror. Tha disk coatroXJLar ratumad 
uaaspacbKl or ineoaprahansibia iaforaation 
to tha BIOS. Try tha oparation again, tf 
tha arror paraista« ehack tha hardwura. 
If tha arror doas not eoaa froa tha 
hardiNirat it is causad by an frror in tha 
iatamal logic of tha BIOS. Contact tha 
plACa you purchasad your systaa for 
asaistanea. You should provida tha 
foUowing laJSoraatioas 



a Ihdieata which varsion of tha oparating 
ay at a a you ara using. 

aOascriba your syataa'a hardwara 
conf igura tion. 

a Provida sufficient information to 
raproduca tha arror. Indicate which 
prograa was mzming at tha tiioa tha 
arror occurred. If possible, you 
should also provide a disk with a copy 
of tha prograa. 
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Table A-1. (coat-inued) 



Message 



MaaniAg 



BIOS ERKOR — DISK X HOT SXJPPORTED 



BIOS error > The disk drive indicated t 
the variable X is act supported by th 
BIOS. The BDOS supports a aaxinun of 1 
drives, lettered h through P. Check th 
dccuaentation provided by the nanuf acture 
for your system coaf iguration to find ou 
which of the BOOS drives your BIC 
impleaents. Specify the correct driv 
code and reenter the cooaand line. 



BIOS ERROR —■ Invalid Disk Status 



BIOS error. The disk controller returne 
unexpected or inconprehensible informatic 
to thm BIOS. Try the operation again. I 
the error persists t check the hardware 
If the error does not cose fro& th 
hazd%axa, it is caused by an error in th 
internal logic of the BIOS. Contact th 
place you purchased your system fo 
assistance. You should provide th 
following inforvationt 



Indicate which version of the operatin 
systasi ypu are using. 

Describe your system's hardwar 
coaf igura t ion. 

Provide sufficient inforaation t 
reproduce the error. Indicate whic 
program was ruxming at the time th 
error occurred. If possible* yo- 
should also provide a disk with a cop; 
of the program. 
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Itosaagtt Nttaalag 



CP/M Disk ch«ng« «rror oa driv« x 



01 Jk ttrror. Th« diak in th* driv« 
Indicatad toy thm variabl* x is not th« 
MLA« di«k th« «yst«a logged In previously. 
Wlien Um disk was rsplacsd* you did oat. 
sntsr 4 CTIUL-C to Xog in Uis currsat disk. 
Th«ir«£or«f virh«n you attsoptisd to writs to, 
•ras«* or rsnams a fils on ths currtust 
disk/ ths BOOS sst ths drivs status to 
Rttad-*Oaly and warm bootsd ths systsa. Ths 
ourrsnt disk in ths drivs was not 
ovsrwrittsn. Ths drivs status was 
rsturasd to Rsad-Writs whsn ths systsa was 
vmsm bootsd. 

1fi%«±i tiflut a disk Is Chang sd, you sust typ<s 
a CSSU>>C to log in ths nsw disk. 



CP/M Disk fils sirtorar Jilsnaas is r sad-only. 
Oo you want t^x JShanf s it to rsad/writs (c}» 
or Atoort CA|T 

Pisk sirror. ?oa attsoptsd to writs to» 
•rass/ or rsaaas a fils t^oss status is 
ilsad'-Oaly. Spselfy ons o£ ths options 
itilelossd in parsnthssss. l£ you spseify 
ths C option* ths aoos changss ths status 
of ths fils to Rsad-Writs and oontinuss 
ths op«iutation. Ihs Rsad'-Oaly protsction 
prsvlGRisly assigned to ths fils is lost. 
I£ you spsoify ths A option or a CTKL->C, 
thm program tsrainatss and C9/Ht-8000 
rs turns the systsm prompt. 



CP/M Disk rsad srror on drivs x 

DO you want tot Abort (A), Rstry {R} 

or Continus with bad data (O? 



Disk error. This aessags indicatss a 
hardware error. Specify one of the 
options encloasd in paranthsass. Each 
option is dsscribed below. 
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Table A— 1. ( cant.inued } 



Message 



MaaniBg 



A or 



Terni nates 
CP/M-8000 
prompt . 



the operation and 
returns the systes 



Retries the operation. If the 
retry fails, the systen reprompts 
with the option message. 

Ignores the error and continues 
prograa execution. Be care£ul if 
you use this option. Program 
execution should not be continued 
for soae types of programs. For 
example, if you are updating a 
data base and receive this error, 
but continue program execution, 
you can corrupt the index fields 
and the entire data base. For 
other programs, continuing 
program execution is recoBuaendsd. 
For exajiple, when you transfer a 
long text file and receive an 
error because one sector is bad, 
you can continue transferring the' 
file. After th« file is 

transferred, review ths file, and 
add the data that was not 
transferred due to the bad 
sector . 



CP/M Disk vfrite error on drive x 

Do you want to: Abort (A), Retry (R), 

or Continue with bad data (C)7 



Disk error. This message indicates a 
hardware error. Specify one of the 
options enclosed in parentheses. Each 
option is described below. 



A or Terminates the operation and 

CTRI/-C CP/M-aoOO returns the system 
prompt. 

R Retries the operation. If the 

retry fails, the system reprompts 
with the option message. 
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Table A~I. (continu€td) 



Message 



Meaning 



Ignores the error and contiiuiee 
prograa execution. Be careful if 
you use this option. Prograa 
execution should not be continued 
for soaui types of programs. For 
exaaple« if you are updating a 
data base and receive this error 
aessage but continue prograa 
execution* you can corrupt the 
index fields and the entire data 
base. For other prograas. 
continuing prograa execution ia 
recoaaended. For exajsple* when 
you transfer a long text file and 
receive an error aessage because 
one sector is bad« you can 
contizuae trans far ring the file. 
After the file is transfarrad* 
review the file, and add the data 
that Mas not transferred due to 
the bad sector. 



C7/M DisJc select error on drive x 

Do you want toi Abort (A), Batry (R) 



Disk error. There is no disk in the drive 
or the disk is not inserted correctly. 
Ensure that the disk is securely ixxserted 
in the drive. If you enter the R option, 
the systea retries the operation. If you 
enter the A option or CT1I*-C the prograa 
terainates and CF/M-SOOO returns the 
systea proapti. 



CP/M Disk select; «irror on drive x 



Disk error. The disk selected in the 
coaaand line is outside the range A 
thirough P. CP/M-QOOO can support up to 16 
drives r lettered A through P. Check the 
docuaentation provided by the manufacturer 
to find out which drives your particular 
s^'stea configuration supports. Specify 
ti!ie correct drive code and reenter the 
coaaand line. 
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n -i^ - w. 



'•'.3 :;3aaes 



Ta^le A— 1. ( cont.inue>d ) 



Maasagtt 



Meaning 



DIRECTORY FULL 



ED error. There La not enough directory 
space £or th.m file being written. 

You can use the OX filespec command to 
erase any unnecessary files on the disk 
without leaving the editor. 
Alternatively, you can save the contents 
of the aaaory buffer on another disk with 
the command BtXf ilespec. where filespec is 
a file on a different drive. You can then 
quit the edit. If you reedit the file. 
the output should be placed on a different 
drive with the command £D filespec d: 
where d: is a valid drive name other than 
the drive containing the source file. 

You can read the file saved with the 
Rfilespec command, btote that part of the 
file Bight not be in the memory buffer 
when you save it (if you have not appended 
the whola fils or if you have issued any W 
commands ) . 



DISK FULL 



£D or PIP arror. In SD, the message 
indicates that there is not enough disk 
space for the output file. This error can 
iDccur on the V, Z. E, or X commands. If 
it occurs with the X command you can 
repeat the command, prefixing the filename 
with a different drive. Otherwise, you 
can try the recovery methods described 
above urwiar the DIRECTORY FULL error. In 
PIP, this message indicates that the 
destination disk is full. 
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Taibia A-1. (continued) 



Message 



Meaning 



Disk select error on Destination 
Disk select error on Source 
EHROR 



Disk or COPY error. The disk selected in 
the command line is not suf^»orted by CP/M-> 
dOOiO. CP/M->6000 can support up to 16 
drives* lettered A through P. Check the 
documentation provided by the manufacturer 
to find out which drives your partieulau: 
system configuration supports. Specify 
the correct derive code and reenter the 
command line. 



E2tE0R: BAD PARAMETER 



PXF error* Tlie command contains an 
illegal parameter. Befer to Section 5 in 
this manual on the PIP ccranand for an 
axplanation ^d listing of the PIP command 

parameters. Reimier the ci^uiand with a 

valid paraaamter:. 



ERROR: CLOSE FILE - (filespecJ 



PIP error. The output file specified in 
the previous PIP command caxmot be cloeed. 
Thim aeeeage indicatee a fatal error in 
the internal logic of PIP. Contact the 
place you purchased your system for 
assistance. You should provide the 
following information: 



e Lsdicate which version of the operating 
system you are using. 



e Oescr ibe your 
conf igura tion. 



sys tern ' s hardwar « 



Provide sufficient information to 
C(sproduce the error. Indicate which 
program was running at the time the 
error occurred. If possible, you 
should also provide a disk with a copy 
of the program. 
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Table A-1. (continued) 



Message Meaning 



ERROR: DESTINATION IS R/0, DELETE (Y/N)? 



PIP error. The destination file specified 
in a PIP coinma.nd, already exists and it is 
Read-only. If you type Y, the existing 
file is deleted and replaced with the file 
specified in the PIP conuaand. If you do 
not want to delete the existing file, type 
N and reenter the PIP coaaiand with a 
different destination file sp^^cif ication: 
either specify a new filenaa^, or direct 
the destination file to a different disk. 
This aessage can be avoided by: using the W 
option. Rfifer to Section 5 of this aanua.1 
on the PIP conannd for a discussion and 
list of the PIP ODtions. 



ERROR: DISK FULL - [filespec] 



PIP error. PIP cannot read the input file 
indicated by the variaJale, filespec. This 
oessage indicates a bad disk. Ensure that 
the disk is in place suid try the operation 
again. If the error persists, the disk, is 
bad and must be replaced. COPY or PIP as 
much of the bad disk ais possible, or use 
your backup disk, if you saintained one, 
to replace the lost files. 



ERROR: DISK WRITE - {filespec] 



PIP error. The disk to which PIP is 
writing is full. The file indicated by 
the variable, filespec, ,wes not copied. 
Reenter the PIP command line and redirect 
the output to another disk, if possible. 
If you do not have another disk available, 
you must erase unnecessary files, if any,' 
or replace the disk before you reenter the 
PIP command line. 
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Table . A-1 . ( continued } 



Message 



Meaning 



ERKQR: FILE dOT FOUND - {fiilespec} 



9 IF error. The input file indicated by 
the variable* filespec, does not exist, or 
the drive code or user nuaber is 
incorrect. Ensure that you are typing the 
correct filename and drive code, and that 
you are in the correct user nuaber or have 
specified the c<»'rect user nuaber in the 
option brackets before you reenter the PIP 
command line. 



SBROR: HEX RECORD <SHECKSUM * Ciilespec) 



PIP error. A hex recstfd checksum error 
was encountered during the transfer of a 
hex file. This message indicates a 
corrupted or truncated hex file, aecopy 
cr PIP the hex file from your backtip 
di»km, if possible. .If you <to not hsve a 
back up r you must erase the bad file and 
recreate it . : . 



ERROR I mVKLZD DESTINATION 



PIP error. The destination specified in 
your PIP command is illegal. Yoa have 
specified an input device as a 
destination* or used a wildcard file 
specif ication* Reapecify the PIP eonaand 
with an output device or a specific file 
as the destination. Refer to Section S of 
this oanual on the PIP coaaand for a 
discussion of the valid PIP destinations. 



ERROR: INVAI*ID FORMAT 



PIP error. The format of your PIP coaaand 
is illegal. Refer to Section 5 of this 
ntap'r'^ y on the PIP coaaand for the correct 
syntax. 
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Table A-1. (continued) 



Message 



Meaning 



ERROR: INVA-LID HEX DIGIT - Ifiieapec) 



PIP error. An invalid hex digit has been 
encountered while reading a hex file. 
This message indicates a truncated or 
corrupted hex file. Recopy or PIP the 
file from your backup disk. If you do not 
have a backup, you must erase the bad file 
and recreate it. 



ERROR: INVALID SEPARATOR 



PIP error. You have placed an invalid 
character £or & separator between twc 
Input filenames. Reeuater the PI? command 
line using a comma as the separator 
between the input filenamea. 



ERROR: 



INVALID SOURCE 



PIP error. The source specified in your 
PIP command is illegal. You have 
specified em output device as a source or 
used a wildcard filename. Reenter the PIP 
command line with an input device or a 
specific filename as the source. Refer to 
Section 5 of this manual on PIP for a 
discussion of the legal sources for a PIP 
command. 



ERROR: 



INVALID USER NUMBER 



PIP error. You have specified a user 
number greater than 15. User numbers 
range from to 15. Reenter the PIP 
commnnd line using a valid user number . 



ERROR: NO DIRECTORY SPACE - Ifilespec] 



PIP error. The disk to which PIP is 
writing has no directory space available. 

Erase unno.cesaary files, if any, or 
replace the disk before you reenter the 
PIP command line. 
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Tatola A-i- (continuad) 



Maflsaigtt 



Maeining 



ERROR I 
ERROR: 



OPEH FILE 
OPQI FII£ 



File tlot Found 
CSYS3TEM FILE 



- (filespac) 



PIP error. The first oeaaage indicates 
that PIP could not find the source file 
specified in the PIP aomnand line. Check 
the directory of the appropriate drive and 
user number for the correct spelling of 
the file. The second neasage indicates 
that the source file specified in the PIP 
coMBiand line is a system file, that la, a 
file with the SYS attribute set. You auat 
use PIP'S R option to enable PIP to find a 
system file. 



ERROR: QUIT HOT FOOSD 



PIP error, Tha atrtx^ argument to a Q 
parametar was not found in your input 
file. Ensure that you typed the correct 
atring and try th« operation again. .This 
error can aXao occur when entering the Q 
option from the CP/M-dOOO command line. 
GP/M-8000 transiataa everything in the 
ee»ttand line into uppercaae. To avoid 
this problem* eater the Q option from 
inside PIP. Enter PIP/ and wait for the * 
prompt before entering the file 
specifications and Q option. 



ERROR I START iilOT FOUND 



PIP error. The string argument to an S 
parameter could not be found in the source 
file. Ensure that you are typing the 
correct string and try the operation 
again. This error can also occur when 
entering the S option from the CP/M-QOOO 
command line. CP/M-SOOO translates 
everything in the command line into 
uppercase. To avoid this problem, enter 
the S option from inside PIP. Enter PIP, 
and wait for the * prompt before entering 
the file specifications and S option. 
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Taisle A-1. (cont.inuedJ 



Message 



Meaning 



ERROR: UNEXPECTED END OF HEX FILE - {file spec) 

PIP error. The last hex record wa.s not as 
long as che character count indicated. 
The hex file is truncated. Recopy or PIP 
the truncated file from your backup disk. 
If you do not have a backup, you must 
erase the bad file and recreate it. 



ERROR: USER ABORTED 



PIP error. You aborted a PIP operation by 
entering a CTRL-C or by pressing a key. 
If you do not intend to abort the 
operation, you must reenter the PIP 
conuaand line. 



ERROR: VERIFY - ifileapecl 



PIP error. vrhen copying with the V 
option, PIP found a difference when 
rereading the data just written and 
conpering. it to the data in its neaory 
buffer. This, indicates a bad disk or a 
hardware erroc. Try the operation again. 
If the error persists, insert a new disk 
and reenter the PIP command line. If the 
error still persists, check the hardvnire. 



Extraneous argument ignored: argument? 



COPY error. The command line contains too 
many arguments- The extraneous arguments 
are indicated by the variable, arguments. 
The command was carried out up to, but not 
including, the extraneous arguments. 
Safer to Section 5 in this manual on COPY 
for the correct syntax of the COPY command 
line. Reenter the command line with the 
correct syntax for the remaining 
arguments. 
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"Cable A-1. (continued) 



Message 



Meaning 



7il« already exists 



BLSSI error. The naae specified In the 
coonand line as the new filenaae air|iady 
exists. Use the ERA conuoand to delete the 
existing file if you want to replace it 
with the new file. If not, select another 
filename and reenter the REH conaand line. 



?IL£ IS REJU3/0£iLy 



ED error. A Read-Only file cannot be 
Mated with the SD coanand, ED filespec. 
*^he command, ED inputfilespec 
outputf ilespec, should be used instead. 



FILS mr SPCIND 

riLS mT 70UI3D - t f ilespac} 



W* StAT error. ED or STAT could not find 
the file Indicated by the variable* 
filespec. Check the filename* drive code, 
and user nui&ber before you reenter the 
coaiumd line. 



?IL£liAME RfiQUZKSD 



SO error. The ED conaand was typed 
without a filenaae. Reenter the SO 
eonnand followed by the name of the file 
you want to edit or create. 



Format'ting Error 



fORIlAT error. This message indicates 
either a bad disk or a hardtAre error. 
Try the operation again. If the error 
recurs, replace the disk with a new disk. 
If the error persists, look for a hardvHira 
error. Contact your technical support 
personnel or the place you purchased your 
system for assistance. 
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Table A— 1. (continued) 



Message 



Htt2m.ing 



Insufficient nemory or bad file header 



CCP error. This error could result from 
one of three causes: 



• The file is not 
coiamand file. 



valid executable 



• The program is too large for the 
available aefflory. 

• The program is linked to an absolute 
location in maiaory that cannot be used. 



Ensure that you are requesting the correct 
file. This error can occur when you enter 
the filename before you enter the cosusand 
for a utility. Check the appropriate 
section of this User ' s Guide or the CP/.M- 
8000 Prograaaer's Guide for the correct 

r^rimm^r^ri "ayncAaf ejArnrm you reenter the 

coomand line. If you are trying to run a 
program when this error occurs, the 
program file might have b*csn corrupted. 
Reassemble or recompile the source file 
and relink it before you reenter the 
command line. 

Add more memory boards to the system 
configuration, or rewrite the program to 
use less memory. 

The program must be made relocatable or 
linked to a usable memory location. The 
BOOS Get/ Set TPA Limits Function (63) 
returns the high and low boundaries of the 
memory space available for loading 
programs. See the CP/M-8000 Programmer's 
Guide for more information on Function 63. 
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Tabltt A— I. ( continnad ) 



Msasage 



Mmaniag 



INV2ULZD ASSIGSMElilT 

USS< STAT DtFXLSNAMB.TYF CSZZS] CRO] CRH] CSYS] OR COIRl 

SIAT error* An ixiv-alid film assignaant 
was attaaptad. Tha error aaaaaga is 
followad by tha correct syntax and a list 
of tha valid fila aaaigmuinta. Raiar to 
Saction 5 o£ this a&nual on tha STAT 
coaaand for. a dlacuaaion of fila status 
aasignaants. Specify a valid file 
aasignaant and raantar tha STAT coaaand 
Ham, 



ItlVALID FlLEliAME 



Ed error. Tha filaaaaa spacifiad is too 
lon(|» or a daliaitar-was used as tha first 
character. Fllanaaaa cannot ba longer 
than eight characters. Refer to Saction 2 
of this aanual on naoxng files for a list 
and daseriptioa of the daliaitara that 
cannot ba usad aa tha first character in a 
filanaaa. Correct the filenajtta and 
raantar the SO coaaand line. 



Invalid or missing drive coda 



FOSa^T error. Tha FORMAT coaaand line is 
either aissing a drive coda spaeif ication* 
or tha drive spacifiad is net supported by 
tha BDOS. C?/H-dOOO can support up to 16 
drives, lettered A through P. C!heck tha 
docuaantation provided by tha aanufacturer 
to find out which drives your particular 
systaa configuration supports. Specify 
the correct drive coda amd reenter the 
coaaand line. 



No file 



CCP, COPY« ERA, REli error. The filensune 
specified in the coaaand line does not 
exist. Ensure that you use the correct 
filenaae and reenter tha coaaand line. 
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Tat»le A-1. (continued) 



Message 



Meaning 



iJO MEMORY 



ED error. There is not enough space in 
available meiDory to create the buffer that 
ED requires to edit a file. Contact your 
technical support personnel or place of 
purchase for assistance. This problem can 
occur when ED is absolutely linked too 
high in the TPA to allow for the buffer. 
SD needs 4K of memory at a location 
immediately higher xr. memory than itself 
for a buffer. Relocate ED to a lower 
location. If ED is not linked too high, 
reconfigure the TPA of your system, if 
possible, by eliminating- soma system 
extensions. If it is not possible to 
reconfigure the TPA, additional memory 
boards must be added to the system 
configuration to run ED. 



Ho i^ildc&rd filenaiMa 



CCP, REM error. The command specified in 
the coaaand line does not accept wildcards 
in file specifications. Retype the 
command line using a specific filename. 



OUTPUT FILE. EXISTS, ERASE IT 



ED error. This error occurs when placing 
the destination file on a different disk 
than the source. The destination filename 
already exists on the receiving disk. The 
existing file should be erased or another 
disk selected to receive the output file. 



Prdcram Load Error 



CCP error. This massage indicates an 
undefined failure of the BDOS. Reboot the 
system and try again. If the error 
persists, than it is caused by an error in 
the internal logic of the BDOS. Contact 
the place you purchased your system for 
assistance. You should provide the 
followino information: 
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TiabXa Ar-I. (continued) 



Message 



^feK^ing 



• liadicate which version ot the operating 
systea y^ra are using. 



p«scribe your 
ctmfiguxra, tion. 



systen's hardware 



• Provide sufficient infornation to 
reproduce the error. Indicate which 
prograa was running at the tiae the 
error occurred. If possible, you 
should also provide a disk with a copy 
of the program. 



RSAD error '••' 



Track I t Sector: s 

COPY errfflf . This measage Indicates a bad 
di«lc. The variable* t, is replaced with 
the nuaber of the track where the error 
<aecitunr«4* The variable, s, is replaced 
with the waaber of the bad sector. Try 
the operation again. If the error 
p«esl»ts. lise a nmt disk and COPY or PIP 
«• igAny files as possible fron the damaged 
disk. If you cannot COPY or PIP a file, 
yoo must replace the file from your backUEp 
disk. If you have not maintained a backup 
disk, you must recreate the lost file. 
Oiseaxd the damaged disk. 



read error on program lomd 



CCP error. This message indicates a 
premature ead*-of-f ile. The file is 
smaller than the header information 
indicates. Sither the file header has 
been corrupted or the file was only 
partially written. If the program is one 
you have written, you oust reassemble or 
recootpi'le the source file and relink It 
before you reenter the command line. If 
this message occurs at any other time, and 
you have a backt^ copy of the program you 
were running, erase the program file and 
replace it from your backup files. If the 
error recurs, contact your technical 
support personnel or the place you 
pureiiased your system for assistance in 
locating the cause of the error. 
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Table A— 1. (continued) 



Message 



Meaning 



READ ONLY DRIVE STATUS NOT ALLOWED 



STAT error- Read-Only drive status" ia not 
supported by CP/M-8000. Assign each file 
on the disK Raad-Only status individually. 



Select Error 



FORMAT error. Th:.s aessage indicates one 
of three errors: 



• The drive specified is not supported by 
your system. 

• The dis)c on the drive selected is not in 
place. 

• A hardware error. 



CP/M-8000 supports a maximua of 16 drives* 
lettered A through P. Check the 
doctuDftntation provided by the stahufactursr 
to find out which of these drives your 
particular system configruration supports. 
Reenter the coBmand line with a valid 
drive code specification. 

ChecJc the disJc. Ensure that it is 
securely in placs and that the drive door 
is closed. 

If the disk is in place and you have 
selected a valid drive code, look for a 
hardware error. The error might have been 
caused by a loose connection or damaged 
drive. Contact your technical support 
personnel or the place you purchased your 
systam for further assistaunce. 



Source and Destination must be different 



COPY error. The source and destination 
drives specified are the same. Reenter 
the COPY command line with a different 
drive for the source than for the 
destination. 
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Itatblfl Ai>l. (contiauad) 



Mtt«aag« 



Msaiaing 



SUB file not fouad 



SUBMIT error. The file requested either 
doee not exist or doea not have a file type 
of SUB. Eaaure that you are requesting 
the correct file. Refer to Section 5 in 
this oanual on SUBMIT for information on 
creating and uaing suboit filea. 



Syntax: EUSSf newf ile^oldf ile 



KES error. The syntsue of the WSS coamand 
line ia incorrect. The correct syntax Is 
given in the error aeaaage. Enter the REN 
cramwinrl followed by a space, then the new 
filename* followed iaaediately by an 
equals sign and the naae of the file you 
want to 



Too many arguawntas argument? 



OIR» EBAf TYPE, USER error. The command 
line contains too many arguments. The 
extraneoua arguments are indicated by the 
variable, argument. Refer to Section S 
in tiiia manual for the correct syntax for 
the coamand. Specify only as many 
arguamnta aa the command syntax allows and 
reenter the command line. Use a second 
<»maand line for the remaining arguments, 
if appropriate. The command night be 
repeated on one command line when 
separated by an exclamation point; for 
exaaqple, 

OIR a:10IR b: 
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Message Meaning 



TOO HMn FILES 

TOO MANY ENTRIES IN INDEX TABLE 



STAT error. There ic not enough aeaory 
for STAT to sort the files specified or 
more than 512 files were specified. Move 
soiae files to another user number. 
Otherwise, brsa)c the group of files into 
smaller. groups before you reenter the STAT 
command line. ?or example, use a wildcard 
(♦.typ) to run STAT on only those files 
vifith a certain filetype. 



Undefined option 



COPY error. The option specified in the 
COPY command line is unsupported. The 
only COPY options supported by CP/M-8000 
ar« a, for automatic, and v, for verify. 
Correct and reenter the COPY comoand line. 



User t rang* is [0-153 



CCP error. The user number specified in 
the command line is not supported by the 
BIOS. The valid range is enclosed in the 
square brackets in the error message. 
Specify a ussr number between and 15 
(decimal) wh«n you reenter the command 
line. 



Write Error 



FORMAT error. This message indicates 
either a bad disk or a hardware error. 
Try the operation again. If the error 
recurs I replace the disk with a new disk. 
If the error persists, look for a hardware 
error. The error might have been caused 
by a loose connection or damaged drive. 
Contact your technical support personnel 
or the place you purchased your system for 
further assistance. 
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Table A->I. (contliiuttd) 



g« Meaning 



«£ .—• .> Tnekz t Sectors s 

COPY error. 'Shis aeeaage indicates a bad 
diak. The variable* t« la replaced with 
the nuadser of the track where the error 
occurred. The variable^ a* ia replaced 
with the nusyser of the faiad sector. Try 
the operation again. If the error 
persists, use a new disk i&nd copy as many 
files as possible froa the damaged disk. 
If you cannot copy a file, you oust 
replace the file froa your backuqp disk. 
If you have not naintained a backv^ disk, 
you oust recreate the lost file. Discard 
the daaaged diak. 



2nd of Appendix A 
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Filetypes 



CF/M-aoOO ld«htif i«s «v«ry fil« by a oiiiqutt fila apacif ication, 
which conaiata of a driv« apecif ication, a fil«naaui« a 
fil«typ«, and an optional paaaword. Th« filatypa ia an 
^jptional thr<Mi<-<:haract«r ending 8«paratad txom th« £ilanaa« by 
a period. Th« filat^nP* g«n«rally Indicataa a spacial kind o£ 
«il«. Th« following tabia liata coanon fiiatypaa and thair 
oManinga. 



TSabla &-1. COBaon Fil«typ*a 



Typ« 



8101 
dKS 

aAK 



c 

28K 

H 

HIQC 



PBU 

TMP 



Maaning 



Aaaaobly ianguaga aourca fila; tha CP/M>dOOO 
Aaaaoblar aaaaaUalaa or tranalataa an ASM fila 
into oAchina languaga. 

Sagaantad aaaaobly languaga aourca fila. 

Baekiap fila craatad by taxt aditor r tha aditor 
ranaaaa tha aourca fila with thia filatypa to 
indicata that tha original fila haa baan 
procaaaad. Tha original fila ataya on diak aa 
tha backup fila, ao you can rafar to it. 

Prograa aourca fila writtan in tha C languaga. 

ZSOOO cxacutabla prograa fila. 

ilaadar filaa for C languaga prograaa. 

Prograa fila in haxadaciaal foraat. 

Coapiladi or aaaaablad object filaa. 



Printable 

printer. 



file, diaplayable on conaole or 



AJISK temporary file uaad while archiving new 
librarioa. ABSK, the CP/M-8000 Aaaeabler, ia 
explained in the CP/M~eOOO Proqraaaer ' s Guide . 
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Table B-l. ( conrisuied) 




Type 


Meainlng 


SUB 


Fiietype required for submit file 


containing one 




or more CP/M-8000 coainands. The 


SUBMIT program 




executes commands in flies 


of type SUB, 




providing a batch execution mode 


for CP/M-8000 - 


SYS 


System file for CP/M-QOOO. 




$55 


Temporary file, inaccessible to 


user. 



£nd at Appendix B 
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CP/M-SOOO Control 
Cliaracter Smnmary 



Tabl* C'-l. C7/MKQ000 Coatxol Quuractsrs 



K«ystrok« 



Action 



CTRZi->C TangdnatAfl Axacutin? tranaiant utility program. 
Alao tnralnatas OZR, DZRS, SUBMIT/ and TfPS 
built-in programa In prograsa. Whan antarad aa 
fixat ehajp&ctar in a conaand lina or during tha 
axaoution of tha abova-aantionad prograoa. 
CTSULt'C cauaaa a Mara a tart and tha radiaplay of 
tha ayataa proaqst. (Saa Section 4 for a 
diaevtaalon of tmoi start. .) 

C7RIr>8 Vorcwa a phyaleal carriaga ratum but doaa not 
sand tha conaand lina to CP/M"dOOO. eiovaa tha 
aarsor to tiba baginAing of tha toUowing Una 
; «iithoat araaing your pravioua input. 

CTSXr-a Oalataa a ehazaetar and iaov«a tha euraor la ft 
ona c±i«£aet»r poaitioa. 

CTBXr-£ Mov«s tha ouraor to tha naxt tab stop. Tab 
atopa ara autoaatieally sat at aach aighth 
coluaa* Baa tha saaa affact aa tha TAB kay. 

C7HX(-J Movaa tha ouraor to tha laft of tha currant 
Ha* aad smxd* tha coaaand Una to CP/M-SOOO. 
Saa tha aaaa affact aa a carriaga ratum 

kayatrioka. 

CTXULr>M Mov«a tha ctiraokr to tha laft of tha currant 

lina and sanda tha coaaand lina to (^/M-dOOO. 
aaa tha saaa affact aa a carriaga ratum 
kayatroka. 
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TaJDle C-1 



(contiauedl) 



Keystroke 



Action 



CTR1/-P Echoas a.Ll console activity to dne printer. 

You cam «■« CTRlf-P after you halt scrolling 
with CTRL-S. A second CTRL-P aaads prin.ter 
echo. If your computer is not connected to a 
printer, typing a CTRLr-P can cauae your systea 
to hang,' requiring a cold start, that ia, a 
complete resetting of your hardware and 
software. (See Section 1 for a description of a 
cold start. ) CTR.L-Q Restarts screen 

scrolling after a CTRIr-5. 

CTRIr-R Displays "#" at the current cursor location, 

moves the cursor to the next line, and retypes 
any partial comxaand you have typed so far. 

CTRL-S Stops screen scrolling. If a display scrolls 

by too fast for you to read it, type CTRIr-S. 
GTRL-Q restarts screen scrolling. 

CTRIr-U Discards all the characters in your command 

line, displays "<* at the current cursor 
position, and moves the cursor to the next 
command line. 

CTRIi-X- Diseaxds all the characters in the conuaand line 
that you typed so far and moves the cursor bacyc 
to the beginning of the current line. 



End of ADoendix C 
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FOKMAT Command 



Syntax: 



FORMAT idiflk driv«s} 



Explanation: 



Digital !Uia«areh providaa a format utility, callad 
FORHAT, that is coopatibla with CP/M-8000 auid tha 
Olivatti* M-20 Gooputar. The Olivatti M-20 hardwara 
ia daacribad in tha CP/M-8000 Operating System Syatan 
Quidf . Thia utility formats S-i/4-inch floppy 
diakattaa only. 

Foraatting astablishaa the desired disk density 
(doud^le density), the desired sector size (256 bytes 
per sector), and the number of tracks (40) 
appropriate for the disk. Formatting makes a disk 
ready to receive new data from another disk havix^ 
the identical format. Thus, formatting is a 
preliffiinarjr, and often aeceaaary, step to copying. 

Although you can often set the density and sector 
size by uaing a formatting utility, you have no 
control over the number of tracks that are selected 
by t^e utility. That parameter ia determined by the 
particular disk controller logic inside your disk 
cabinet; it is hardwares-dependent. Consequently, 
computer hardware manufacturers often write the 
formatting utilities to go with the hardware they 
sell. 

Vlhether you format a floppy diskette or a hard disk, 
all files on the disk are erased as part of the 
formatting procedure. The utility's behavior depends 
on the version supplied you by the manufacturer of 
ymir equipment. 



examples s To execute FORMAT at the CF/M-dOOO command level, use 

the form: 

A>FORMAT ds 

where d: specifies a drive in the range a... p. Take 
care to include the colon following the driva letter. 

After you press RETURN, FORMAT responds with the 
following prompt: 
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Warning: This will destroy all files on diaJc d:l 



Do you wish to continue? 

Press Y for yes. in either upper- or lowercase, if 
you want to continue. Reply with N for no, if you 
decide not to format disk d. If you reply to the 
above question with any character other than Y, 
FORMAT aborts execution and returns you to the 
cosmand level of CP/M~e000. 

If you respond with a Y, FORMAT prompts: 

Ia»art disk to b« £or&at'ted in drav« di ajad press RCTURS. 

After inserting a diskette in the appropriate drive 
amd pressing RETURN, FORMAT begins formatting the 
dxakette and displays the message, "Formatting track 
n", where n is the track number currently being 
formatted. 



£Uid of Appendix D 
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Glossajry 



•■bigiioaa filMuuMs Fil«aajMi that eontalntf «ith«r of th« CSjw* 
8000 vriJLdeard charact«ra» ? or *, in th« prlaary tilmammm or 
tli« filatyp* or both. Wh«n you r«plae« charaetara 1a a 
filanaaa with thaaa wildcard charactarSf you craata an 
aaibiguoua filanaiM. and can aaaily rafaranca aora than ona 
CP/M-aoOO file in a Jiingia cottnand Xln: 

inpJi.c««iaii« prograat Prograa that naada an operating ayataa 
to provide an anvironaant in which to axacuta. Typical 
ac^licationa prograoa are buaxnaaa accounting paekagaa. word 
proeaaaing (editing) prograaaf and aailing liat prograaa. 

a^gmaaats Syabol« uaually a letter « ixadica ting a place Into 
which you can aubatituta a nual»er« letter # or nam to give an 
^propriate aeaning to the foraula in ^eati^i. 

AflCXCx The Alaecican Standard Code fior Xn£on»tioa Interchange 
ia a standajpd code for the repreaentation ot mxgSBmSMi letters, 
and ayabola. An ASCII text file ia a file that can be 
intelligibly diaplayed or printed on paper. 

alrtrJPbRituis ?ile character ia tic that can be set to OH or OF?. 

baektips Copy of a diak or file oade for aafe keeping; alws 
ueed aa a v«rb« to bacK up, aeaning to create a copy of a diak 
or file. 



aaaic Oiak Operating Syatea*<»-a CP/M->a000 operating 
ayatea aodtxle that diracta all activitiea aaaociated with the 
file ayatea. 

BlOSa Baaic Input/Output Syatatt*— >a CP/M~d000 operating syataa 
nodule that provldea the interface functions aaaociated with 
input/output proceaaea. 

bits Switch in aeaory that can be set to OM (1) or OFF (0). 
31 ta are grouped into by tea. 

bloeks Disk storage araa reserv«d for a sp«cific a««. 

bootatraps Proeaaa of loading an operating systaa into maBory. 
Bootstrap procadurea vary froa systaa to systaa. The boot for 
an operating systaa auat be custoalzed for the aeaory size and 
hardware anvironaant that the operating systea aanagas. 
Typically, the boot is loaded autoaatically jmd executed at 
power up or. when the coaputar is react. Soaetiaea callad a 
cold start. 
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btiffar: Axea of momory that temporarily storea data during the 
transfer of information. 

Ixiiit-in e n— an d 8 : Coauaanda that permanently reside in aeaory. 
Iliey respond quickly because they are not accessed from a disk. 

by-t«: Unit of aamory or disk storage containing eight bits. 

rrwmax i d s Elements of a CP/M-8000 command line. In general, a 
CP/M-aoOO c omman d has three parts: the command keyword, the 
co mman d tail, and a carriage return. 

rn— ii i ii nl file: Series of coded machine-executable instructions 
stored on disk as a program file, invoked in CP/M-8000 by 
typing the command keyword next to the system prosit on the 
coneoie. The CP/M-SOOO command files generally have a f iietype 
of Z3K.. Piles are either command files or data files. Same as 
a command progrzim. 

e nwiinri koy*iord: Same that identifies a CP/M-8000 command, 

usually the primary filename of a file of type 28K, or a built- 
in command. The command keyword precedes the command tail and 
the carriage return in the command line. 

command syntax: Statement that defines the correct way to 
enter a command. The correct structure generally includes the 
c om mand keyword, the command tail, and a carriage return. A 
syntax line usually contains symbols that you should replace 
with actual values when you enter the command. 

command tails Part of a comnand that follows the command 
keyword in the c o mma n d line. The command tail can include a 
drive specification, a filename or f iietype, and options or 
parameters. Some commands do not require a- command tail. 

concatenate: PIP operation that copies two or more separata 
files into one new file in a specified sequence. 

console: Primary input/output device. The console consists of 
a listing device, such as a screen and a keyboard, through 
i^ich you communicate with the operating system or applications 
program. 

control character: Nonprinting character combination that 
sends a simple command to CP/M-8000. Some control characters 
perform line-editing functions. To enter a control character, 
hold down the CONTROL key and strike the character key 

spetcif ied. 

cursor: One-character symbol that can appeetr anywhere on the 
console screen. The cursor indicates the position where th«s 
next keystroke at the console will have an effect. 

data file: Nonexecutable collection of similar information 

that generally requires a commajid file to manipulate it. 
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dtofauXt: Currently selectad diak drive and uaer nuaber. Any 
eoamand that doaa not specify a disk drive or a uaer nuaber 
m^erencea the default diak drive and uaer nuaber. When CP/M- 
8000 ia first invoked* the default diak drive ia drive A., and 
the default uaer nuaber ia (until changed with the USER 
cc— and ) . 

daULaitars S^wcial characters that separate different itfaa in 
a coaaand line. For exaaple* in CP/M-dOOO, a colon aaparataa 

the drive apecif ication froa the filenaae. A period aeparatea 
tha filenaae froa the filetype. Brackets separate any optiona 
froa their coaaand or file specification. Coaaaa separate one 
itea in an option Uat froa another. All of these special 
characters are deliaiters. 

4ireetocyi Portion of a disk that contains entries for each 
file on the disk. In response to the OIR coaaand. CP/M-«000 
displays the filenaae* stored in the directory. 

sm m^txib^tm* fila attribute. A file with the DXR attribute 
can be displayed by a OZR coaaand. 

diaic, diskattat mgaatie aadia usad to store inforaation. 
frograaa and data *re recordad on a diak in the saae way that 
-mmia is recorded on a cassette tape. Tha term diskette refers 
to saaller capacity, reaovable floppy disks. Disk can refer to 
m diskette, a ra«ovabla cartridge disk, .or a fixed hard disk. 

d&sfe dciva« Peripheral device that reads and writea on hard or 
floppy disks. C9/M-3000 assigns a letter to each drive under 
its control, for exaaple, CP/M-aOOO can refer to tha drives in 
a four-drive systsa as A, B, C, and D. 

iidil»rt Utility prograa that creates and aodif iee text filea- 
te editor can be used to create docuaenta or source code files 
for eoaputer prograas, Tha CP/H-«000 editor is invoked by 
typing the coaaand SO next to the systea proapt on the eonaole. 



__„_„ IS Ready to be run by the conputer. Bacecu table coda 

is a series of instructions that can be carried out by the 
eoaputer. For example , the computer cannot execute naaea and 
adlreaaes. but it caja execute a program that prints all those 
naaas and addreaaea on nailing labels. 

eaacnta a pcograsit To start a prograuB. Vlhen a prograa is 
running, the eoaputer Is executing a sequence of instructions. 

FCBc File Control Block. 

filet A unique collection of characters, instruct ions, or data 
stored on a disk. You can create filee on a disk. 

file Control Block: Structure used for accessing files on disk. 
Contains the drive, filename, filetype, and other information 
describing a file to be accessed or created on the diak. 
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£iXazu9LKe: £2aae assigned to a file. A filenajae can include a 
primary filename of 1-8 characters and a filecype of 0-3 
c^iaracters. A period separates the priaaxy filenauae from the 
f iietype. 

£lle specification: Unique file identifier. A conplete CP/M- 
SOOO file specification includes a disk drive specification 
followed by a colon (d:}« a primary filename of 1 to 8 
characters, a period, and a filetype of to 3 characters. Par 
example, b : example . t ex is a complete CP/M-dOOO file 
specification. 

£iletyp«ir Sxtension to a filename. A filetype can be from 
to 3 characters and must be separated from the primary filename 
by a period. A filetype can tell something about the file. 
Certain prograiBs require that files to be processed have 
certain filetyp«s. 

floppy disk: Flexible magnetic disk used to store information. 
Floppy disks come in 5-1/4 and 8 inch diameters. 

bard dJlrnks Rigid, platter-like magnetic disk sealed in a 
oontainmr. A hard disk stores more information than a floppy 
dlalc. 

haurdwttjretr Physical components of a computer. 

tmx flltt.t ASCII -printable representation of a command (machine 
language) fil«« 

heczadecijULL notation t dotation for the base 16 number system 
using the symbols Ci, 1, 2, 3, 4, 5, 6. 7, 8, 9, A, B, C, 0. £, 
and F to represent the sixteen digits. Machine code is often 
converted to hexadecimal notation because It can be easily 
represented by ASCII chajraetersr and therefore displayed or 
printed. 

iapat: Data going into the computer, usually from an operator 
typing at the tarmxnal or by a program reading from a disk. 

interfacei Object that alleys two independent systems to 
communicate tirith each other, such as an interface between 
hardware and software in a nacroeomputer . 

I/O J Abbreviation for input /output, 

kaywonl: See enemnnd kc^vord. 

kilobyte: 1024 bytes, denoted as IK. 32 kilobytes equal 32K. 
1024 kilobytes equal one megabyte, or over one million bytes. 

list dervieei Device such as a printer onto which data can be 

listed or orinted. 
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logged ins Mada known to th« op«rating systam* in rafarenca to 
drivas. A drlva la loggad in whan it is salaetad by tha 
OfMirator or an axacuting procaaa. It raaiains salactad -or 
loggad in until you ehanga disks in a floppy disk driva or 
aatar CXItL-C at tha eoaaand laval. 

109ioai.s Raprasantation of soayathlng that night or night not 
ba tha saaa is its »etual physical fora. For axaapla, a hard 
disk can occupy ona physical dxiva* and yat you can divlda its 
airailabla storaga so that it appaars to tha usar as aavaral 
diffarant drivas. Thaaa apparant drivas ara tha logical 
drivas. 



n Ovar ona laiillion bytas; 1024 kilobytas. Saa byta, 
kiloiayta. 



■Lgg o pr ocaaaor » Silicon chip that is tha Cantral Procaaaing 
Unit (ora) of thm aicroccsqiatar . 

Opamtiog aY«t«Mi» Odllaction of progsmas that suparviaaa tha 
axacution of othar prograas and oanagas tha coaputar's 
rasourcaa. hn operating ayataa providaa an ordarly 
input/output attvirQ»tiaaat batwaan tha coaputar and its 
par ipharal davicas. It aaablaa uaar-Mrittan programs to 
aaeaeuta- aasily. 

qyfticMK Ona of sMiiy paraMitars that c«a ba part of a eoaaand 
tail. Qmm options to spaeifiy additional conditions for a 

i'a axacution*' 

t Data that tha prosaasor sanda to tha consols or disk. 



rs Valua in tha caaaand tail that providaa addit ional 
iaforaation for tha eoaaand. Ta^mii»illy, a paraaatar la a 
smqpUxmd alaaant of « eoaaand* 



daaioaas ' Oavioaa axtarnal to tha GPU. For axaapla, 
tarainals« printara* and disk drivaa ara coaaon p4urlpharal 
darvicaa that ara not part of tha proeaaaor^ but ara usad in 
eoajuaetioa with it. 

phyaioalx Actual hardwara of a ctnqputar. Tha physical 
aavironawit variaa firoa coaputar to coaputar. 

priaary filanaaat First 8 charaetars of a filanaaa. Tha 
priaary filanaaa is a aniqua naaa that halpa tha asar Idantify 
tha fila eontants. A priaary filanaaa contains 1 to 8 
alphanuaaric charaetars and can includa aona apacial 
charaetars. Tha priaary filanaaa followa tha optional driva 
apacification and pracadas tha optional filatypa. 



IS Sariaa of apacially eodad instructions that par form 
spacific tasks whan axacutad by a coaputar. 
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ptcoaqpt.: Any characters displayed on the video screen to help 
the user decide the next appropriate action. A systea prompt 
is a special prompt displayed by the operating system. The 
aystem prompt indicates that the operating system is ready to 
accept your input. The CP/M-8000 system prompt is an 
alphabetic character followed by eui angle bracket. The 
alphabetic character indicates the default drive. Some 
applications prograias have their own special prompts. 

Raad-Only: Attribute that can be assigned to a dia)c file. 
Every file euid drive is either Raad-Qniy or Read-Write. When a 
file is set to Read-only , you can read from that file but not 
write any changes to it. The default setting is Read-Write. 
Any error in resetting the disk or changing media automatically 
sets the entire drive to Raad-Only until the error is 
corrected. 

aflad-Writs: Attribute that can be assigned to a disk file. 
'Vne Read-Write attribute allows you to read from and write to a 
specific file so marked. See Rsad-OoXy. 

record: Collection of data. A file consists of one or more 
records stored on disk. An CP/M-8000 record is 128 bytes long. 

SO: Abbreviation for Raad-Qnly. 

BWs Abbreviation for Read-Write. 

sector: Portion of a disk -track. There are a specified nuaiber 
of sectors on each track. 

softwaret Specially coded programs that transmit machine- 
readable instructions to the computer, as opposed to hardware— 
the actual physical components of a computer . 

BOttTce file: ASCII text file that is an input file for a 
processing program, such as an editor, text formatter, or 
assembler. 

syntax: Format for entering a given command. 

system attxHaates A file attribute. You can give a file the 
system attribute by using the SYS option in the STAT command. 
A file with the SYS attribute is not displayed in response to a 
DIR command ,• you must use OIRS to view a directory of files 
having the system attribute. 

system prompt: Symbol displayed by the operating system 
indicating that the system is ready to receive input. See 
proi^pt. 

terminal; See conmola. 

track: Concentric rings dividing a disk. There are 77 tracks 
on a typical eight- inch floppy disk. 
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tqra-lc«Y application 3 Application dsaignad for tt 

coapu tar -or i«nt«d usar. For axajqpla, a typical tw 
amplication la daaignad so that tha oparator aaada only t 
on tha cadiputar» Inaart tha propar pro^raa disk and aala* 
daaixad procadura fron a aalaction of funetiona 
dlaplayad on tha scxaan. 

opiMUcd-ooapntiblas Tarn naanin? that a pro^ran craatad t 
fnnnrLously ralaaaad oparating systaa (or coapilar, ate. 
andar tha nawly rala&aad varsion o£ tha aana oparating my 



'i Stusbar aaaigaad to fllaa in tha diak diractc 
that diffarant uoars working froa tha sane diak^ naad daal 
with thair own filaa and hava thair own diractoriaa. In 
aOOO, fiilaa can ba dividad into 16 uaar groups (0«15}. 

ntililrys Tool. Frogran that anablaa tha uaar to p*^ 
curtain oparationa* such aa copying filaa, araaing fiilaa 
adit log £ilaa. Utilitiaa ara craatad £or tha eonvaniaz* 
prograaaMra and aaara. 

wild««Jrtl dMjntetacrst Spaoial charaetars that aatcdi cm 
sp«oi£iad itaaa. In C?/M*dOOO thara ara ' two wll. 
<diara«3tacs» 7 and *. Thm ? can ba subatitutad £or any fc 
ebaractar in a £ilanaaa» and tha * can ba subatitutad fici 
priaary fiilanaaa or tha filatypa or both. By placing wil: 
GhAraetars in Cilanaaaa* you can craata an aabiguoua £ili 
and <qtuickly ra£asaae« oaa or sMara £ilaa. 
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$^$ til; 5-16 

in (Through Lin* Huabvir) 



K <A|ifp«nd) Gowaand, 6-4 
abort a coE>y ^•ratios # S-20 
aec««a BOd«fl# S-aj, 3-34, 9-36 
activ* 

status* 3-3X 

uasut nujBbaraf ^5-37 
assign pl^sical d«vic« to 

logitsal dsvic*, 5-3d 
attributes f S-33 
AXIS, 3-3, S-20 
AXOt 3-3 r $-20 



B (BsgizAixtg/Bottoii) 

CcMBUnd* 6-8 
b«cki9 disks, 1-4 
basic sditiag coaaaux&a, 6-7 
booting ths systsa, I-i 
built-i|t consaads, 4-1 
bytss» S-34 



C ( Chaxaetsr ) Contand, 

6h8, 6-lS 
diaraetsr 

£>oiat«r* 6-6 

trans far, 5-19 
eoJLd staiTt, l-l 
coabinsd-coausaad Xins, 6-14 
coabining filaa. 5-19 
conaazid 

dascription, 4-10 

ksyword, 1-2, 4-10 

lina, 1-2 

aoda, 6-12 

tail, 1-2 
COHj, 3-3, S-20 
concatanation, 5-19 
control char act ar. 1-2 
copy, 1-4, 1-5 
COPY conmand, 5-2 
copy filas to and £roa 

auxiliaxry davicas, 5-20 



CP» 6-6 

CTBL kay, 1-2 

CntXr-B, 6-21 

GTSL-Z, 5-19, 5-21, 6-12, 6-20 

cursor, 1-2 



(Oalata) Coamand, 6-10 
data filaSf 2-1 
d« fault 

driva, 2-3 

usar nujsbar, 5-18 
dast-£ilaspac, 4-13 
OEVs, 5-38 
davic* naaas, 5-21 
OZa. 5-6, 5-33, 5-36 

(Biraetory) Coaaand, 
1-2, 5-6 
diraetory, 2-1, 2-6 

attributa, 5-33 

<nstrias* 5-34 

i^paca,' 2-6 

varifioation, 3-34 
OZBS (Systaa Oiraetory) 

Coaaand, 5-6 
disk 

fraa apaea, 5—32 

spaca allocation, 5-34 
display 

scrolling, 3-1 

disk status, 5-37 
OKI (dalata oharaetara) 

option* 5-24 
driva, 2-7 

spacifiar, 2-2, 2-4, 4-7 



S (acho) option, 5-17, 5-24 

B (Exit) Coaaand, 6-5 

SD, 2-1' 

Coaaand, 5-8 
Coaaand Suanary, 5-9 
Error Syabols, 6-25 
aassagaa, 6-2, 6-19, 

6-25. 6-27 
proapt, 6-2, 6-12 
syntax, 6-1 

aditing, 6-16 

•ditors, 6-1 
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enc-of-file character, 5-19 

EOF:, 5-20 

ERA Command. 5-13 

Examples, 4—10 

executable file, 2-1 



F I filter fora-fe«d8) 
option. 5-24 

F ,Find) Command, 6-18 

FCS. 5-34 

file. 2-1 

-ittritautes, 5-16 
categorie*. 2-2 
^roncatenation, 5-19 
specif i cation, 4-7, 5-34 

fxxanaae, 4-7 

fiiatype, 2-2, 4-7 



line 

editing controls, 6-13 

numbers, 6—4 
line-editing control 

characters, 3-2 
loading CP/M-SOOO, 1-1 
logical 

device, 3-3, 5-20, 5-38 
long form of PIP, 5-17 
LST:. 3-3. 5-20 



M (^iacro) Command, 6-21 
memory buffer, 6-2, 6-3 
multiple 

command ausde, 5*23 

file copy, 5-18 



Gn option, 5-15, 5-16, 
5-19, 5-24, 



H 



H (Head of File) Command, 6-23. 
H (hex data transfer) 
option, 5-25 



a (add line numbsrs) 

option, 5-25 
a (lilumber} Command, 6-9 
U Command, 6-19 

n: (Line Number) Comjumd, 6-'I7 
mJLi. 5-20 
numeric argxiaent, 6-6 



I (ignore) option, 5-25 
I (Insert) Command. 6-12 
input devices, 3-3 
input-output port, 5-39 
insert mode, 6-12 
Ismng^Z (Insert String) 
Command, 6-13 



(object file transfer) 
option, 5-25 

(Original) Comaiand, 6-24 

option, 5-19 
on-line 

disk, 2-7 

status, 5-37 
Options, 4-10 
output devices, 3-3 



Juxtapose) Command, 6-20 



K (Kill) Command, 6-11 
kilobytes, 5-34 



L 



L (Line) Command. 6-8, 6-15 
L i translate case) 
option, 5-25 



P (Page) Command, 6-17 
physical device 

drivers, 5-39 

names, 5-38 
PIP. 2-1, 

command, 5-15 

messages, 5-18 

options, 5-16. 5-23 
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Pn (a«t pag« length) 

option, 5-26 
pound aiga argua«nt, 6-6 
PRHs, £-21 
program fil«, 2-i 



Q (Quit) Coaiuand, 6-24 

g« (quit copying) option* 5-26 



R (read syatoim £il«s} 

opt:ion« 5-26 
R (Raad) Cooaand, 6-23 
RMd-Oniy, S-31 

«ttribut«« 5-33 

lilaa« 5-16 
R««d-«lrit«, 5-31 

attribata* 5-33 
saail^ status. 2-7 
raal fila aiza* 5-34 
ffsoociis* S— 33 
rsaovariitg froa aditing arror 

conditions* 6-26 
Baes, S-33 
SJEH 

en— and, 5-29 

aa«a«gaa, 5-30 
g aaa t, 2-7 
BSTUfisr )e«y. 1-2 
RO, 5-31, 5-33, 5-36 
RH. 5-31, 5-33, 5-36 



sat £ila accaas oodaa, S-^dd 
short form of PIP, 5-17 
aingla fila copy, 5-15 
SIZZ, 5-34 

aeurca fila, 6-2, 6-3 
squara brackats, 5-16, 5-23 
Sa (start copying) 

option, 5-26 
STAT 

eoaauud, S-31 

aaaaagaa, 5-32, 5-34 
syntax, 4-10 

notation, 4-12 
SYS, 5-33, 5-36 
syataa 

attributa, 5-33 

prompt, 1-2, 2-7 

reaat, 1-1 



T (Typa) Conaand, 6-9, 

6-15, 6-16 
tab charactars, 5-45 
taaporary 

fila, 5-16 

work fila, 6-2 
taxt adit or, 2-1 
taxt transfer ^aaands, 6-4 
Tn (expand tabs) option, 5-27 
transient coaaands, 4-1 
TYPE 

Coanand, 5-45 

aassagas, 5-45 



13 (tanmslate case) option, 5-26 
Uf (Upparoisa Tranalation) 

Coaaand, 6-13 
iSBKB, coaaand, 5-47 
as«r Quabars, 3-37, 5-47 
utility coaaaada* 4-1 



V (varify) option. 5-17, 5-27 
VALt, 5-38 
varaion nuidsar. 1-1 
virtual fila siaa, 5-34 



(writs o9ar} option, 5-27 
(Write) Coaaand. 6-5 
wildcard, 4-€, 5-33 

charactars , 2-5 



X (Transfer) Coaaand, 6-22 

X$$$$$$$.LIB file, 6-23 



Z (zero the parity bit) 

option, 5-27 
ZSK, 2-3 
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